update-docs

Update README.md files to reflect code changes in changed folders.

8.6k|564|Updated May 22, 2023
One-click install
npx skills add https://github.com/anyproto/anytype-ts --skill update-docs-anyproto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-docs
Source: https://github.com/anyproto/anytype-ts/tree/main/.claude/skills/update-docs
Command: npx skills add https://github.com/anyproto/anytype-ts --skill update-docs-anyproto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures documentation stays current by updating READMEs to match code changes across changed folders, keeping docs lean and aligned with the implementation.

Core Features & Use Cases

  • Delta-driven documentation: only update sections affected by code changes.
  • Co-located governance: README files live next to the code they describe.
  • Maintenance scenarios: after adding, removing, or refactoring components/abstractions, run this skill to refresh docs.

Quick Start

  1. Identify folders with code changes.
  2. Update the corresponding README.md files to reflect the changes.
  3. Review the generated diffs and commit the documentation updates.

Frequently Asked Questions about update-docs

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

FAQPage Schema
How do I keep my README documentation in sync with code changes automatically?

Keeping documentation in sync involves applying delta-driven updates to only the README sections affected by recent code changes. This ensures co-located docs remain accurate and aligned with the implementation without manual rewriting.

What is delta-driven documentation synchronization?

Delta-driven documentation is an approach that updates only the README sections impacted by recent component or abstraction modifications. It avoids rewriting entire files and enforces accurate file counts alongside repository README conventions.

How do I update component documentation after refactoring code?

Updating component documentation after refactoring involves identifying folders with code changes and refreshing their co-located README files to reflect added, removed, or modified abstractions. Review the generated diffs and commit the documentation updates alongside the code.

Does this documentation update approach work for any development workflow?

Yes, this approach applies to any development workflow where components or abstractions are modified, added, or removed. It triggers the need to refresh in-code documentation and keeps docs aligned with the latest implementation across the repository.

When should I run a documentation synchronization process?

You should run a documentation synchronization process after adding, removing, or refactoring components within your codebase. This maintenance step ensures your README files accurately reflect new file counts and structural changes before committing.

Why are my README file counts out of date after removing components?

README file counts become outdated when components are removed or added without updating the documentation. Enforcing accurate file counts through delta-driven updates resolves this by automatically refreshing the README to match the current directory structure.