docs-restructure
Installation
SKILL.md
Restructure docs across pages
The failure this skill prevents: an agent asked to "streamline this page" reorders its sections, collapses them into accordions, retitles them, and tabulates them, thirty times over, while the page gets longer. The page was never the problem. Three of its sections already existed on sibling pages.
Single-page skills cannot see that. add-docs-page owns one page's lifecycle and
docs-edit owns one page's diff. This skill owns the question they cannot ask:
is this content on the right page at all?
AGENTS.md holds the navigation map, the style guide, and the frontmatter rules.
This skill covers the procedure around them and does not repeat them.
Step 1. Establish the page family
A page almost never lives alone. Find its siblings before reading it closely: