Documentation
README
Authoring Poirot Skills
Overview
A SKILL.md can live in two places:
- Builtin (in-repo):
poirot/backend/agents/skill/builtin_skills/<category>/<name>/SKILL.md— committed, shipped with the package. Usewrite_file+git add. - User-local:
skills/<name>/SKILL.md— personal, gitignored. Created via/skill install <path>or by writing directly.
This skill covers authoring for both, with emphasis on builtin skills.
When to Use
- User asks you to add a skill "in this repo / commit"
- You're committing a reusable workflow that should ship with Poirot
- You're editing an existing skill under
builtin_skills/
Required Frontmatter
Source of truth: poirot/backend/agents/skill/parser.py::parse_skill_file.
Hard requirements:
This is the opening of the README. Read the full README on GitHub.