latest
- every bundled skill ships MEMORIES.md (memory-skill template, name substituted); autotest frontmatter check enforces its presence (SPEC 4.7) - copy_skill: MEMORIES.md is add-only - installed from the bundle when missing, never overwritten, on both install and update; --force does not change this (SPEC 4.7, 6.8, 7.6); uninstall removes it with the directory (SPEC 6.9, sad by design) - FIX bug in --update: it passed the skill directory where the skills root was expected, copying the bundle into skills/<name>/<name>/ and never refreshing the real SKILL.md; now updates the real files and heals the legacy nested directory on the next copy (SPEC 7.7) - tests strengthened to assert file contents, not just output: 84 total, all checks green; e2e-verified via the installed pipx CLI 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 <skill> --uninstall remove it again (project scope: add --project)
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 |
|---|---|---|---|
| fiona | 2.2.0 | productivity | Operate an llm-wiki with the fiona-assistant CLI |
| memory | 1.0.1 | productivity | Give a skill its own MEMORIES.md beside its SKILL.md |
| python-tdd | 1.2.0 | development | Minimalist TDD architect for Python work |
| sectionize-markdown | 1.2.0 | documentation | Number headings and list items so each rule can be cited |
| specification-writer | 1.1.0 | documentation | Write structured, maintainable SPEC.md files |
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, and md025 treats front-mattertitlekeys as headings off, so skills with atitleplus one#stay clean - 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%