create-docs skill

A Claude Code skill that systematically analyzes a project and writes or refreshes a suite of LLM-optimized documentation files — covering architecture, build, testing, development patterns, deployment, and a file catalog — plus a synthesized README. Every generated file includes a UTC timestamp and concrete file references so both humans and LLMs can navigate the codebase quickly.

Inspired by steipete/agent-rules update-docs.

features

• analyzes the codebase across 7 key areas in parallel
• writes to docs/ by default; --output <path> redirects all output
• existing files are refreshed by default; --no-overwrite preserves them
• generates a UTC timestamp header in every file so staleness is visible
• each file contains concrete file references (paths, line numbers, code excerpts)
• enforces no-duplication: each fact lives in exactly one file; cross-references use relative links
• synthesizes a minimal README.md (≤ 50 lines) after all section files are done
• --only <section> refreshes a single file without touching others
• --dry-run prints what would be written without touching the filesystem

usage