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

  1. Analyze changes: Run git diff canary...HEAD --stat to see what files changed
  2. Identify affected docs: Map changed source files to documentation paths
  3. Review each doc: Walk through updates with user confirmation
  4. Validate: Run pnpm lint to check formatting
  5. 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
Installs
2.4K
Repository
vercel/next.js
GitHub Stars
139.4K
First Seen
Jan 22, 2026