docs(coding-agent): clarify skill invocation is model behavior

This commit is contained in:
Mario Zechner 2026-01-25 20:55:10 +01:00
parent a4cb9ff02a
commit c12d18483d

View file

@ -58,7 +58,7 @@ For project-level Claude Code skills, add to `.pi/settings.json`:
1. At startup, pi scans skill locations and extracts names and descriptions
2. The system prompt includes available skills in XML format per the [specification](https://agentskills.io/integrate-skills)
3. When a task matches, the agent uses `read` to load the full SKILL.md (ideally; models often need prompting or explicit `/skill:name`)
3. When a task matches, the agent uses `read` to load the full SKILL.md (models don't always do this; use prompting or `/skill:name` to force it)
4. The agent follows the instructions, using relative paths to reference scripts and assets
This is progressive disclosure: only descriptions are always in context, full instructions load on-demand.