docs-update-from-diff

Update docs/ pages to match uncommitted git diff changes.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Heron11/otter-code --skill docs-update-from-diff-heron11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-update-from-diff
Source: https://github.com/Heron11/otter-code/tree/main/.qwen/skills/docs-update-from-diff
Command: npx skills add https://github.com/Heron11/otter-code --skill docs-update-from-diff-heron11

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents documentation drift by making sure docs/ content reflects the current uncommitted git diff instead of outdated text, so readers always see the latest behavior.

Core Features & Use Cases

  • Diff-first investigation: Analyze git status, git diff --stat, and focused git diff output before touching docs so the updates are grounded in actual code changes.
  • Targeted documentation edits: Follow the docs surface map to pick the precise docs/users or docs/developers page (and the right _meta.ts when adding pages) that should capture the new workflow, flag, or behavior.
  • Verification checklist: Confirm links, examples, and terminology match the current CLI, search for removed names, and re-read the updated docs alongside the original diff to ensure accuracy.

Quick Start

Review the git diff and update the relevant docs/ pages to match the new behavior.

Frequently Asked Questions about docs-update-from-diff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update documentation to match git diff changes?

Update documentation from git diff by first running git status and git diff --stat to identify changed files, then editing the targeted docs/ pages to accurately reflect the new code behavior.

Why does my project documentation drift from current code changes?

Documentation drifts from code changes when docs/ files are not refreshed after features or refactors, leaving readers with outdated text that fails to match the actual updated behavior.

What is the best way to keep docs synced with git uncommitted changes?

Keep docs synced with uncommitted changes by analyzing git diff findings, referencing docs-surface guidelines, and editing targeted docs/ pages to precisely align with the current code updates.

Do I need to inspect git diff before editing docs files?

Yes, you should inspect git diff before editing docs files to ensure updates are grounded in actual code changes, preventing outdated terminology and aligning descriptions with updated behavior.

How do I add new documentation pages for features revealed by git status?

Add new documentation pages for features revealed by git status by following the docs surface map to select the right docs/developers page and updating the corresponding _meta.ts file to register it.

What should I check after updating documentation from git diff?

After updating documentation from git diff, confirm links and examples match the current CLI, search for removed names, and re-read the updated docs alongside the original diff to verify accuracy.