How do I install the Docs Sync skill?

Run npx skillmds@latest add tomevault-io/docs-sync in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Docs Sync safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Docs Sync?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Docs Sync free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Docs Sync?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Docs Sync by tomevault-io — Agent Skill

Name: Docs Sync
Author: tomevault-io

Docs Sync

Rewrites stale `README.md` and `docs/*.md` sections based on changes since main. Use before staging, or when asked to "sync docs" or "update the docs". Do NOT use for changelog updates or `CLAUDE.md`/`GEMINI.md` updates. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Docs sync

Read these files from the project root in parallel:

standards/prose.md: prose conventions for all generated text
standards/readme.md: README structure, required sections, and content rules

Context

Run these commands in parallel:

git diff --cached main -- . ':(exclude)*.lock' ':(exclude)*-lock.json' 2>/dev/null || echo "NO_DIFF"
git diff --cached --name-only main 2>/dev/null || echo "NO_FILES"
git status --short 2>/dev/null || echo "NO_STATUS"

Guards

If git diff --cached main output is empty and git status --short output is empty, stop: ❌ No changes since main. Nothing to sync.

Discovery

Discover docs dynamically. Do not hardcode paths:

Glob README.md at project root
Glob docs/**/*.md

Read each discovered file in parallel.

Analysis

For each discovered doc, classify as one of:

stale: the diff touches something the doc describes
unrelated: no overlap between diff and doc content

Classify at the section level, not the file level. A doc edited earlier in the session can still be partially stale. For each diff surface, verify the corresponding section is synced.

Action

Rewrite only the stale sections. Do not touch sections unrelated to the diff. Write the updated file immediately after the preview. Claude Code's tool permission dialog is the confirmation gate. Do not wait for user input.

Response format

Preview

Changes since main: <n> files Docs discovered: <list>

Doc	Status	Action
README.md	stale	update
docs/api.md	unrelated	skip

After outputting the preview, write all stale updates immediately.

Summary

One line per file, using the same relative path format as the preview table (e.g. README.md, docs/api.md):

✅ Updated: <relative-path>
⏭️  Skipped: <relative-path>

Source: erclx/toolkit — distributed by TomeVault.

---name: docs-syncdescription: Rewrites stale `README.md` and `docs/*.md` sections based on changes since main. Use before staging, or when asked to "sync docs" or "update the docs". Do NOT use for changelog updates or `CLAUDE.md`/`GEMINI.md` updates. Use when this capability is needed.---# Docs syncRead these files from the project root in parallel:- `standards/prose.md`: prose conventions for all generated text- `standards/readme.md`: README structure, required sections, and content rules## ContextRun these commands in parallel:- `git diff --cached main -- . ':(exclude)*.lock' ':(exclude)*-lock.json' 2>/dev/null || echo "NO_DIFF"`- `git diff --cached --name-only main 2>/dev/null || echo "NO_FILES"`- `git status --short 2>/dev/null || echo "NO_STATUS"`## Guards- If `git diff --cached main` output is empty and `git status --short` output is empty, stop: `❌ No changes since main. Nothing to sync.`## DiscoveryDiscover docs dynamically. Do not hardcode paths:- Glob `README.md` at project root- Glob `docs/**/*.md`Read each discovered file in parallel.## AnalysisFor each discovered doc, classify as one of:- `stale`: the diff touches something the doc describes- `unrelated`: no overlap between diff and doc contentClassify at the section level, not the file level. A doc edited earlier in the session can still be partially stale. For each diff surface, verify the corresponding section is synced.## ActionRewrite only the stale sections. Do not touch sections unrelated to the diff. Write the updated file immediately after the preview. Claude Code's tool permission dialog is the confirmation gate. Do not wait for user input.## Response format### Preview**Changes since main:** `<n>` files**Docs discovered:** `<list>`| Doc | Status | Action || ----------- | --------- | ------ || README.md | stale | update || docs/api.md | unrelated | skip |After outputting the preview, write all stale updates immediately.### SummaryOne line per file, using the same relative path format as the preview table (e.g. `README.md`, `docs/api.md`):```plaintext✅ Updated: <relative-path>⏭️ Skipped: <relative-path>```---> Source: [erclx/toolkit](https://github.com/erclx/toolkit) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions