docs-sync

Sync repository documentation using git change signals and a declared focus.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents documentation drift by applying minimal, verifiable updates to repository docs based on concrete change signals and a focused scope, ensuring docs remain accurate without inventing facts.

Core Features & Use Cases

  • Collects git signals (status, diffs, recent logs) and resolves a focus (user, dev, feature, release, all) to determine a precise target set of files.
  • Performs section-level, minimal-diff edits only where changed components are referenced, marks unverifiable facts as TBD, and updates SKILL.md description lines in dev mode only.
  • Runs pcc-refresh after edits to keep the project context cache consistent and can optionally open a PR when repository git.pr_mode permits; ideal for updating feature docs after code changes or keeping changelogs and READMEs current.

Quick Start

Run docs-sync with an appropriate focus (user|dev|feature|release|all), include slug when focus=feature, and set pr=auto to request a PR if desired.

Frequently Asked Questions about docs-sync

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

FAQPage Schema
How do I keep repository documentation in sync with git changes automatically?

To keep repository documentation in sync with git changes, this Skill reads git status, diff, and log outputs to apply minimal, verifiable edits to README, docs, and CHANGELOG files. It only updates intersecting target sections based on concrete change signals.

What is the best way to update README and docs after modifying code in a repository?

The best way to update README and docs after code modifications is using a focus-driven sync tool. You provide a focus argument like user, dev, or feature, and the tool applies section-level minimal diffs only where changed components are referenced.

How do I prevent documentation drift in my git repository?

You prevent documentation drift by applying minimal, accurate diffs driven by git change signals and a declared focus. This ensures docs remain accurate without inventing facts, marking any unverifiable information as TBD during the update.

Can I automatically open a PR after updating repository documentation?

Yes, you can automatically open a PR after updating repository documentation. By setting pr=auto, the tool optionally opens a pull request according to the repository git.pr_mode settings after running pcc-refresh to keep the context cache consistent.

Does updating SKILL.md description lines require a specific mode?

Yes, updating SKILL.md description lines requires dev mode. The documentation sync process restricts SKILL.md edits to dev mode only, while standard README, docs, and CHANGELOG updates occur during targeted reviews or when git reports related file changes.

What are the limitations of using git change signals for documentation updates?

A limitation of using git change signals for documentation updates is that facts not verifiable from the diffs or logs are marked TBD rather than invented. Additionally, updates are scoped strictly to intersecting target sections, leaving out-of-scope documentation untouched.