getcompanion-ai/co-mono
1
0
Fork 0
mirror of https://github.com/getcompanion-ai/co-mono.git synced 2026-04-16 00:03:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

coding-agent: change Pi skills to use SKILL.md convention

Browse source 
Breaking change: Pi skills must now be named SKILL.md inside a directory,
matching Codex CLI format. Previously any *.md file was treated as a skill.

Migrate by renaming ~/.pi/agent/skills/foo.md to ~/.pi/agent/skills/foo/SKILL.md
This commit is contained in:
Mario Zechner 2025-12-12 23:23:17 +01:00
parent 236856aa48
commit 3b2b9abffc
5 changed files with 123 additions and 153 deletions
Download patch file Download diff file Expand all files Collapse all files

14
packages/coding-agent/docs/skills.md
View file

@ -9,8 +9,8 @@ Skills are discovered from these locations (in order of priority, later wins on
1. `~/.codex/skills/**/SKILL.md` (Codex CLI user skills, recursive)
2. `~/.claude/skills/*/SKILL.md` (Claude Code user skills)
3. `<cwd>/.claude/skills/*/SKILL.md` (Claude Code project skills)
4. `~/.pi/agent/skills/**/*.md` (Pi user skills, recursive)
5. `<cwd>/.pi/skills/**/*.md` (Pi project skills, recursive)
4. `~/.pi/agent/skills/**/SKILL.md` (Pi user skills, recursive)
5. `<cwd>/.pi/skills/**/SKILL.md` (Pi project skills, recursive)
Skill names and descriptions are listed in the system prompt. When a task matches a skill's description, the agent uses the `read` tool to load it.
@ -43,13 +43,13 @@ The parser only supports single-line `key: value` syntax. Multiline YAML blocks
### Variables
`{baseDir}` is replaced with the directory containing the skill file. Use it to reference bundled scripts or resources.
Use `{baseDir}` as a placeholder for the skill's directory. The agent is told each skill's base directory and will substitute it when following the instructions.
### Subdirectories (Pi Skills)
### Subdirectories
Pi skills in subdirectories use colon-separated names:
- `~/.pi/agent/skills/db/migrate.md` → `db:migrate`
- `<cwd>/.pi/skills/aws/s3/upload.md` → `aws:s3:upload`
Pi and Codex skills in subdirectories use colon-separated names:
- `~/.pi/agent/skills/db/migrate/SKILL.md` → `db:migrate`
- `<cwd>/.pi/skills/aws/s3/upload/SKILL.md` → `aws:s3:upload`
## Claude Code Compatibility