From b29de1c73d646563236787391b015f49b79fea2a Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Sun, 25 Jan 2026 20:54:10 +0100 Subject: [PATCH] docs(coding-agent): note that models often need prompting to use skills --- packages/coding-agent/docs/skills.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/coding-agent/docs/skills.md b/packages/coding-agent/docs/skills.md index ab17627f..70ead95c 100644 --- a/packages/coding-agent/docs/skills.md +++ b/packages/coding-agent/docs/skills.md @@ -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 +3. When a task matches, the agent uses `read` to load the full SKILL.md (ideally; models often need prompting) 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.