library-docs

Optimize markdown docs in a folder for AI agent consumption — Obsidian-flavored markdown, token-dense rewrite, parallel sub-agent dispatch via the pi-native `Agent` tool (tintinweb/pi-subagents extension), 100% content-integrity preserved. Use this skill whenever the user asks to format, optimize, compress, densify, AI-optimize, or rewrite a documentation folder previously produced by `repodocs-go` or the `organize-docs-skill` (folder containing `metadata.json` + numbered `nnn-*.md` files + `000-index.md`). Trigger on phrases like "format docs", "optimize docs for AI", "compress these docs", "obsidian format", "token dense", "format-docs", "ai-friendly docs", "library-docs format", "rewrite docs for agents", or any equivalent rewrite-for-density request. Runs AFTER `organize-docs-skill`. Requires the `pi-subagents` extension and the `format-docs-optimizer` + `format-docs-verifier` custom agents in `.pi/agents/`.

Organize a documentation folder produced by `repodocs-go` (or any crawler that emits `metadata.json` + `.md` files) into deterministic, lowercase, sequentially-numbered files plus a generated `000-index.md` optimized for AI agent consumption. Make sure to use this skill whenever the user asks to organize, normalize, renumber, sort, index, or clean up a documentation folder, or works with a folder containing `metadata.json` and bulk `.md` documents — even when phrased as "organize these docs", "sort the markdown files", "build me a docs index", "renumber this docs dump", "normalize the filenames", or any equivalent. Trigger on phrases like "library-docs", "metadata.json", "docs folder", "crawler output", "documentation index", "renumber files".