Files
agentskills/docs/docs.json
T
Jonathan Hefner e9dff6b3d2 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>
2026-03-05 11:28:23 -06:00

57 lines
1.1 KiB
JSON

{
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Agent Skills",
"colors": {
"primary": "#7f7f7f",
"light": "#bfbfbf",
"dark": "#404040"
},
"favicon": "/favicon.svg",
"navbar": {
"primary": {
"type": "github",
"href": "https://github.com/agentskills/agentskills"
}
},
"navigation": {
"pages": [
"home",
"what-are-skills",
"specification",
{
"group": "For skill creators",
"pages": [
"skill-creation/optimizing-descriptions",
"skill-creation/evaluating-skills",
"skill-creation/using-scripts"
]
},
{
"group": "For client implementors",
"pages": [
"client-implementation/adding-skills-support"
]
}
]
},
"contextual": {
"options": [
"copy",
"view",
"chatgpt",
"claude",
"perplexity",
"mcp",
"cursor",
"vscode"
]
},
"redirects": [
{
"source": "/integrate-skills",
"destination": "/client-implementation/adding-skills-support"
}
]
}