Files
agentskills/docs
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>
e9dff6b3d2 ยท 2026-03-05 11:28:23 -06:00
History
..
2025-12-18 08:46:08 -05:00
2025-12-18 08:46:08 -05:00
2025-12-18 10:19:21 -05:00

Agent Skills Documentation

This directory contains the source code for the Agent Skills documentation site, which is built using Mintlify.

Development

Run the following command at the documentation root, where docs.json is located:

npx mint dev

View your local preview at http://localhost:3000.

Publishing changes

Changes are deployed to production automatically after pushing to the default branch.