196df53a9b2749ba35324ec43024c49c7f0c6c46
- SPEC.md sectionized with stable ids (sectionize-markdown conventions) - src/phronesis: cli, registry, harnesses (modular, vibe first), state, formatting, completions; argcomplete completion; exit codes per SPEC - phronesis -> version line + skill table (name, version, category, description wrapped below, daedalus-style) - phronesis <category> -> filtered table; close-match typos for skills+categories - phronesis <skill> --install | --project [--harness <name>] [-f] installs whole skill dir; prompt when present; EOF/default = skip; -f no prompt - phronesis --update -> refresh every state entry; warns unbundled; reinstalls missing - state: <config>/phronesis/installed.json, unique by (name, harness, scope) - skill/python-tdd bumped 1.2.0 with category: development - test/ (56 tests, 92% cov) + autotest pytest check with 75% floor; all 7 autotest checks green Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
phronesis
A chest of skills: a repository of SKILL.md instruction packages and
a CLI that lists them and installs them into an agent harness such as
Vibe.
The name is phronesis —
Aristotle's word for practical wisdom: the knowledge a skilled
practitioner has, as opposed to abstract theory (episteme).
Install
pipx install phronesis # or: pip install phronesis
phronesis # list every bundled skill
Command line
phronesis list every skill
phronesis <category> filter the list
phronesis <skill> show one skill and an install hint
phronesis <skill> --install [--harness <name>] install globally (~/.vibe/skills)
phronesis <skill> --project [--harness <name>] install in the project only (.vibe/skills)
phronesis --update update every installed skill
- Already-installed skills prompt before being overwritten;
-f/--forceskips the prompt. - Installations are recorded in a per-machine state file
(
~/.config/phronesis/installed.json), which powers--update. - Shell completion via argcomplete; run
activate-global-python-argcompleteonce after pipx install.
The example table:
Phronesis Version: 0.1.0
skill version category
----------- ------- ----------
python-tdd 1.2.0 development
Minimalist TDD architect for Python work
Layout
phronesis/
├── src/phronesis/ # the CLI package (cli, registry, harnesses, state, ...)
├── test/ # pytest suite
├── skill/ # one directory per skill; ships as package data
│ └── python-tdd/SKILL.md
├── autotest.py # every repo check, single entry point
├── SPEC.md # the full specification (sectionized, citable)
├── README.md, CONTRIBUTING.md, LICENSE
└── pyproject.toml, requirements.txt
Skills
| Skill | Version | Category | Purpose |
|---|---|---|---|
| python-tdd | 1.2.0 | development | 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,category;namematches the directory,versionisx.y.z,categoryis kebab - markdown — markdownlint on every
.mdfile, viapymarkdownlntwith front-matter support;md013(line length) andmd033(inline HTML) are ignored - pytest — the suite in
test/with 75 percent coverage floor
Run all checks:
python -m pip install -r requirements.txt
python -m pip install -e .
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
Languages
Python
100%