docs-sync

Detect code changes via git diff and update affected documentation surfaces.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Nymbo/Skills --skill docs-sync-nymbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-sync
Source: https://github.com/Nymbo/Skills/tree/main/docs-sync
Command: npx skills add https://github.com/Nymbo/Skills --skill docs-sync-nymbo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Keeps documentation surfaces aligned with code changes across README, docs sites, API docs, runbooks, and configuration. Use when the user asks to update docs, ensure docs match behavior, or prepare docs for a release/PR.

Core Features & Use Cases

  • Change detection: Identify changed files via git diff and map to docs surfaces.
  • Docs inventory: Scan common surfaces (README, docs/, ADRs, API specs, runbooks, etc.).
  • Templates & consistency: Apply templates and templates in references to maintain structure.
  • Verification: Validate docs builds and link integrity.

Quick Start

After code changes, run the docs-sync workflow to update the affected docs surfaces and verify with a docs build.

Frequently Asked Questions about docs-sync

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

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

Docs-sync detects code changes via git diff, identifies affected documentation surfaces like README and API specs, and applies targeted updates to keep implementation and docs aligned. Run the workflow after code changes to automatically update relevant docs and verify consistency.

What documentation surfaces can be kept in sync with code?

Documentation sync covers README files, docs/ directories, wiki pages, API specifications, changelogs, and runbooks. The Skill scans these common surfaces, maps code changes to impacted docs, and updates environment variables, API contracts, database migrations, and architectural decisions across all of them.

Can I verify that documentation matches my code after updates?

Yes. Docs-sync includes verification steps that validate docs builds and check link integrity after updates. Linting and build checks enforce consistency between documentation and implementation, catching mismatches before release or PR merge.

How does docs-sync identify which documentation needs updating?

The Skill analyzes git diffs to detect changed files, maps those changes to documentation surfaces, and creates an inventory of impacted docs. It then determines which sections need updates based on the code changes—such as API contracts, environment variables, or setup instructions.

When should I use documentation sync in my workflow?

Use docs-sync after code changes, during feature releases, before merging PRs, or when preparing for deployment. It ensures README, API docs, runbooks, and changelogs reflect actual implementation, preventing user confusion from outdated documentation.

Does docs-sync work with markdown and API documentation?

Yes. Docs-sync handles markdown files in README and docs/ directories alongside API specifications and other documentation formats. It applies templates and consistency rules across all surfaces to maintain alignment with code changes.