Skip to content

Commit 033d7e8

Browse files
committed
docs: add "check available skills" playbook instruction
Teach agents to scan available skills before starting any task, closing the escape hatch where "non-trivial" let busy agents skip. Spec: specs/cmd-purity-cleanup.md Signed-off-by: Jose Alekhinne <jose@ctx.ist>
1 parent 553fd7c commit 033d7e8

3 files changed

Lines changed: 14 additions & 1 deletion

File tree

.context/AGENT_PLAYBOOK.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,14 @@ is running long:
122122
Context compaction happens automatically, but the next window loses
123123
nuance. Explicit persistence is cheaper than re-discovery.
124124

125+
### Check Available Skills
126+
127+
Before starting any task, scan the skill list in your system
128+
prompt to see if a dedicated skill already handles the request.
129+
Prefer invoking an existing skill over ad-hoc implementation:
130+
skills encode project conventions, quality gates, and
131+
persistence steps that are easy to miss otherwise.
132+
125133
### Conversational Triggers
126134

127135
Users rarely invoke skills explicitly. Recognize natural language:

.context/AGENT_PLAYBOOK_GATE.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,11 @@ run tests before moving on. Track progress via TASKS.md checkboxes.
3333
Use the `gemini-search` MCP server for web searches. Fall back to
3434
built-in search only if `gemini-search` is not connected.
3535

36+
## Check Available Skills
37+
38+
Before starting any task, scan available skills to see if one
39+
already handles the request. Prefer skills over ad-hoc work.
40+
3641
## Conversational Triggers
3742

3843
| User Says | Action |

.context/TASKS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ TASK STATUS LABELS:
6060
compliance_test.go for the full list. #priority:medium #added:2026-03-31-005115
6161

6262

63-
- [ ] PD.4.5: Update AGENT_PLAYBOOK.md — add generic "check available skills"
63+
- [x] PD.4.5: Update AGENT_PLAYBOOK.md — add generic "check available skills"
6464
instruction #priority:medium #added:2026-03-25-203340
6565

6666
**PD.5 — Validate:**

0 commit comments

Comments
 (0)