8212ef038d
- 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>
2.0 KiB
2.0 KiB
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
.pyfile parses (ast.parse) - pycodestyle — PEP 8 style on every
.pyfile - shellcheck — every shell script (
.sh,.bash, or shebang) - frontmatter — every
skill/<name>/SKILL.mdcarries a---fenced YAML header withname,version,description;namematches the directory andversionisx.y.z - markdown — markdownlint on every
.mdfile, viapymarkdownlntwith front-matter support;md013(line length) andmd033(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.