Jonathan Hefner b8d2613ac0 Point "progressive disclosure" links at specification.mdx ...

Two links in `best-practices.mdx` and `optimizing-descriptions.mdx`
pointed at `/what-are-skills#how-skills-work`, blocking the eventual
removal of `what-are-skills.mdx`. Redirect them to the existing
`## Progressive disclosure` section in `specification.mdx`, which is a
more natural reference target for the concept.

Also expand that section's lead-in from "Skills should be structured for
efficient use of context:" to a sentence that names progressive
disclosure as a loading mechanism, so readers who follow the link land
on a definition rather than a bare set of structural guidelines. The
original three-level list and `SKILL.md` line-count guidance are
preserved unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

b8d2613ac0 · 2026-04-19 15:09:27 -05:00

History

..

best-practices.mdx

Point "progressive disclosure" links at specification.mdx

2026-04-19 15:09:27 -05:00

evaluating-skills.mdx

Add skill directory to structure diagram in evaluating skills doc

2026-03-13 10:59:58 -05:00

optimizing-descriptions.mdx

Point "progressive disclosure" links at specification.mdx

2026-04-19 15:09:27 -05:00

quickstart.mdx

Remove link to what-are-skills.mdx from quickstart.mdx

2026-04-19 14:25:01 -05:00

using-scripts.mdx

Add "Using scripts" guide for skill creators (#196)

2026-02-27 15:52:36 -06:00