nvaldez 8212ef038d phronesis v0.1.0: skill repository with python-tdd, autotest, docs, MIT license
- skill/python-tdd/SKILL.md ported from ~/.agents (MD029 numbering fixed)
- autotest.py: sanity, python_syntax, pycodestyle, shellcheck, frontmatter,
  markdown checks on every script and md file - all green

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-19 08:54:21 +01:00

phronesis

A repository of skills: self-contained, markdown-defined instruction packages that teach an agent how to work.

The name is phronesis — Aristotle's word for practical wisdom: the knowledge a skilled practitioner has, as opposed to abstract theory (episteme).

Layout

phronesis/
├── skill/                # one directory per skill
│   └── python-tdd/
│       └── SKILL.md      # the skill: front matter + instructions
├── autotest.py           # every repo check, single entry point
├── README.md             # this file
├── CONTRIBUTING.md       # how to add or change a skill
├── LICENSE               # MIT
└── requirements.txt      # autotest dependencies

Skills

Skill Version Purpose
python-tdd 1.1.0 Minimalist TDD architect for Python work

Checks

autotest.py verifies every script and markdown file in the repo:

  • sanity — LF line endings, no committed private keys, file size limit
  • python_syntax — every .py file parses (ast.parse)
  • pycodestyle — PEP 8 style on every .py file
  • shellcheck — every shell script (.sh, .bash, or shebang)
  • frontmatter — every skill/<name>/SKILL.md carries a --- fenced YAML header with name, version, description; name matches the directory and version is x.y.z
  • markdown — markdownlint on every .md file, via pymarkdownlnt with front-matter support; md013 (line length) and md033 (inline HTML) are ignored

Run all checks:

python -m pip install -r requirements.txt
python autotest.py               # every check
python autotest.py frontmatter   # only the named checks

Adding a skill

See CONTRIBUTING.md. The short version: one directory per skill under skill/, everything the agent needs in a single SKILL.md, and python autotest.py green before you commit.

License

MIT

S
Description
No description provided
Readme MIT 214 KiB
Languages
Python 100%