update-docs

Update README and docs markdown files after code changes using git diff.

11|1|Updated Jan 5, 2015
One-click install
npx skills add https://github.com/ryonakae/dotfiles --skill update-docs-ryonakae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-docs
Source: https://github.com/ryonakae/dotfiles/tree/main/config/.agents/skills/update-docs
Command: npx skills add https://github.com/ryonakae/dotfiles --skill update-docs-ryonakae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document consistency across a codebase can quickly degrade after changes; this skill automatically detects relevant docs such as README.md, CLAUDE.md/AGENTS.md/GEMINI.md, and docs/*.md, and updates them to reflect the latest implementation.

Core Features & Use Cases

  • 変更の検出と同期: git diff/git status を使用して影響を受けるドキュメントを特定し、最新の実装へ更新します。
  • 最小限の変更: 既存のドキュメントのトーンとスタイルを維持しつつ、必要な箇所のみ更新します。
  • 使用ケース: 新機能実装後の更新、API変更後の同期、コミット前の整合性チェックに適用します。

Quick Start

変更を検知した後、ドキュメントを自動更新するワークフローを実行してください。

Frequently Asked Questions about update-docs

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

FAQPage Schema
How do I automatically update project documentation after code changes?

Automatically updating project documentation after code changes involves detecting diffs via git status, identifying affected markdown files like README.md, and applying minimal edits to sync the text with the latest implementation without altering source code.

What is the best way to keep README and docs in sync with API changes?

Keeping README and docs in sync with API changes involves running git diff to detect modified code, locating affected markdown files under docs/, and applying minimal text updates to reflect the new API behavior while preserving the original document tone.

Can I use git diff to detect which markdown files need updating?

Yes, you can use git diff to detect which markdown files need updating by analyzing code changes, identifying impacted documentation like CLAUDE.md or AGENTS.md, and generating a targeted list of files requiring synchronization with the latest implementation.

Does this documentation synchronization approach modify source code or commit changes?

No, this documentation synchronization approach does not modify source code or commit changes. It strictly reads git logs and updates markdown content in README and docs/ files, leaving the actual source code and git history untouched during the process.

When do I need to run a documentation consistency check before committing?

You need to run a documentation consistency check before committing when you have completed a new feature implementation, altered an API, or made significant code diffs that could desynchronize your top-level READMEs or docs/ markdown files from the current codebase.

What types of markdown files are supported for automated documentation updates?

Supported markdown files for automated documentation updates include top-level READMEs, CLAUDE.md, AGENTS.md, GEMINI.md, and any markdown files located under the docs/ directory across software projects, ensuring comprehensive coverage of project guides.