Add "Optimizing descriptions" guide for skill creators

How-to guide covering the full description optimization workflow:
writing effective descriptions, designing trigger eval queries
(should-trigger and should-not-trigger with near-miss examples), testing
trigger rates with a bash eval script, train/validation splits to avoid
overfitting, and the iterative optimization loop.

The guide is client-agnostic by default but includes a working Claude
Code example in the `check_triggered` function using
`--output-format json` and `jq` to detect `Skill` tool calls.

Adds the page to the "For skill creators" navigation group in
`docs.json`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jonathan Hefner
2026-03-05 11:28:23 -06:00
co-authored by Claude Opus 4.6
parent 09055204dd
commit e9dff6b3d2
2 changed files with 194 additions and 0 deletions
+1
View File
@@ -22,6 +22,7 @@
{
"group": "For skill creators",
"pages": [
"skill-creation/optimizing-descriptions",
"skill-creation/evaluating-skills",
"skill-creation/using-scripts"
]