# Organize Reference Docs

> Group an existing reference section into categories — propose the grouping from what the pages document, write each category's index page, and update sidebars.js without moving any file. Load when reorganizing reference docs rather than writing a new page.

- Skill: `zio/organize-reference-docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zio/organize-reference-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zio/organize-reference-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zio (https://skillmd.com/u/zio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zio/organize-reference-docs

---


# Organize Reference Docs

The guide is provided verbatim in the organizing agent's instructions (single source of truth:
`references/guide.md`). It carries how a grouping is proposed and checked, the category index page's
shape, the `sidebars.js` rules, and the bounds that keep a reorganization from breaking links.

Nothing mounts this skill today: `src/organize.ts` imports the reference directly, because a
single-purpose agent needs it on turn 1 of every run and progressive disclosure would only add a turn
and a way to skip it. The directory is a skill so that a consumer which needs it *sometimes* — the
docs-integrator, placing a new page into an existing category — can mount it without moving content.