doc-sync

Detect and report drift between markdown documentation and source code.

1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/cmbays/mokumo --skill doc-sync-cmbays
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-sync
Source: https://github.com/cmbays/mokumo/tree/main/.claude/skills/doc-sync
Command: npx skills add https://github.com/cmbays/mokumo --skill doc-sync-cmbays

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your project documentation accurately reflects the current state of your codebase, preventing outdated information and maintaining a reliable source of truth.

Core Features & Use Cases

  • Drift Detection: Compares documentation against the codebase to identify discrepancies.
  • Automated Reporting: Generates a clear report detailing any detected drift and suggesting fixes.
  • Use Case: After updating API endpoints, run this Skill to verify that APP_FLOW.md and PRD.md still accurately describe the new routes and their functionality.

Quick Start

Run the doc-sync skill to audit all canonical documentation against the current codebase.

Frequently Asked Questions about doc-sync

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

FAQPage Schema
How do I detect documentation drift in my codebase?

To sync project documentation, run an audit that compares markdown files against source code, package manifests, and application routes. The process detects discrepancies across technical specifications and API documentation, generating a report that details the drift and suggests fixes.

What is documentation drift detection and when do I need it?

Documentation drift detection is the process of comparing project plans and technical specifications against the actual codebase to find outdated information. You need it after updating API endpoints or application routes to ensure your markdown files remain a reliable source of truth.

Can I check API documentation accuracy against source code automatically?

Yes, you can automatically check API documentation accuracy by comparing markdown files against source code and application routes. This generates a clear report detailing any detected drift and suggesting fixes to keep your technical specifications aligned with the codebase.

Does doc-sync work with markdown files and package manifests?

Yes, doc-sync works with markdown files and package manifests by comparing them directly against the codebase. It validates project plans, technical specifications, and API documentation by checking application routes and source code to identify discrepancies.

What's the best way to keep technical specifications in sync with code changes?

The best way to keep technical specifications in sync is to run drift detection that compares markdown files against source code, package manifests, and application routes. This generates a report detailing discrepancies and suggesting fixes to maintain accuracy across project documentation.