update-docs
Installation
Summary
Guided workflow for updating Next.js documentation based on code changes and PR reviews.
- Analyzes git diffs to identify affected documentation files using a code-to-docs mapping reference
- Provides templates and conventions for scaffolding new feature docs (components, functions, config, guides, file conventions)
- Walks through step-by-step updates to existing documentation with user confirmation before each change
- Includes validation checklist and linting commands to ensure formatting compliance
- Handles router-specific content using
<AppOnly>and<PagesOnly>components for shared documentation between App and Pages Router
SKILL.md
Next.js Documentation Updater
Guides you through updating Next.js documentation based on code changes on the active branch. Designed for maintainers reviewing PRs for documentation completeness.
Quick Start
- Analyze changes: Run
git diff canary...HEAD --statto see what files changed - Identify affected docs: Map changed source files to documentation paths
- Review each doc: Walk through updates with user confirmation
- Validate: Run
pnpm lintto check formatting - Commit: Stage documentation changes
Workflow: Analyze Code Changes
Step 1: Get the diff
# See all changed files on this branch
git diff canary...HEAD --stat
Related skills