Does it work with Git?

Yes, it analyzes recent git logs and commits to specifically identify deletions or breaking changes that are most likely to have invalidated your docs.

What does DocSync Specialist actually do?

It scans your code and documentation to ensure all examples, function signatures, and file paths are accurate and up-to-date with the current implementation.

How does it verify code examples?

It establishes a 'ground truth' by finding working implementations in your codebase and comparing them against snippets found in your markdown files.

Can it update my files automatically?

Yes, it can identify discrepancies and apply precise edits to fix outdated documentation while preserving the original writing style.

Is it only for IdeaVim?

While optimized for IdeaVim patterns, its core logic of verifying documentation against codebase 'ground truth' is applicable to most software projects.

DocSync Specialist

Name: DocSync Specialist
Author: Microck

byMicrock

•

Content Management

Ensures documentation remains accurate by verifying code examples and API signatures against the current codebase implementation.

DocSync Specialist is a specialized tool designed to bridge the gap between evolving codebases and their documentation. Operating on the philosophy that documentation is 'guilty until proven innocent,' it performs rigorous checks to ensure that READMEs, guides, and API documentation match the actual ground-truth implementation. It excels at identifying breaking changes by analyzing git history, checking for removed parameters, and verifying that every code example in your docs is functionally correct, making it indispensable for maintaining large-scale projects like IdeaVim.

Key Features

01Bidirectional verification between code changes and documentation

02Automated discrepancy reporting with precise corrective updates

03Ground-truth pattern matching using real working implementations

04Git history analysis to detect breaking changes and deletions

05Rigorous API signature and parameter verification for doc examples

0681 GitHub stars

Use Cases

01Updating outdated README examples based on recent git commits

02Performing a comprehensive audit of project documentation directories

03Validating documentation accuracy after a major refactor or API change

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills doc-sync

For use in Claude.ai and ChatGPT

Download Skill