Skip to content

feat: add trigger phrases to skill descriptions for better model matching (v0.6.4.1)#169

Open
garrytan wants to merge 4 commits intomainfrom
garrytan/learn-from-analysis
Open

feat: add trigger phrases to skill descriptions for better model matching (v0.6.4.1)#169
garrytan wants to merge 4 commits intomainfrom
garrytan/learn-from-analysis

Conversation

@garrytan
Copy link
Owner

Summary

  • All 12 skills that were missing explicit trigger phrases now have them — say "deploy this" and Claude finds /ship, say "check my diff" and it finds /review
  • On-demand hooks (/careful, /freeze, /guard) and skill usage telemetry captured as P3 TODOs with implementation notes from eng review

Test Coverage

All new code paths have test coverage. No application code changed — text-only edits to YAML frontmatter.

  • Unit tests: 250/250 passed
  • LLM-judge: 11/11 passed
  • E2E: 21/22 passed (1 pre-existing timeout)

Pre-Landing Review

No issues found.

Design Review

No frontend files changed — design review skipped.

Eval Results

No prompt-related files changed — evals skipped. Full eval suite run manually: 11/11 LLM-judge, 21/22 E2E.

TODOS

Added 2 new items under "Safety & Observability":

  • On-demand hook skills (/careful, /freeze, /guard) — P3
  • Skill usage telemetry — P3

Test plan

  • All unit tests pass (250 tests)
  • All LLM-judge evals pass (11/11)
  • E2E evals pass (21/22, 1 pre-existing timeout)
  • gen-skill-docs freshness verified
  • skill:check health dashboard passes

🤖 Generated with Claude Code

garrytan and others added 4 commits March 17, 2026 22:23
…hing

Anthropic's skill best practices: "the description field is not a summary —
it's when to trigger." Add explicit "Use when asked to..." phrases to 12 skill
descriptions so Claude's auto-discovery works with natural language requests
like "deploy this" or "check my diff", not just explicit /slash-commands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Captures two ideas from Anthropic's skill best practices post:
- /careful, /freeze, /guard on-demand hook skills (P3)
- Skill usage telemetry via preamble JSONL append (P3)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant