Does it support custom Claude skills and rules?

Absolutely. It checks the .claude/skills and .claude/rules directories to ensure that skill descriptions and tool references match the actual project documentation.

Will this skill overwrite my source code?

No, the primary direction of sync is 'Implementation as Truth.' It modifies the documentation to reflect what is actually written in the code.

Can I sync only a specific part of my documentation?

Yes, you can provide arguments such as 'sequence', 'specs', 'architecture', or 'testing' to target specific directories and speed up the audit process.

How does this skill detect differences between code and documentation?

The skill maps specific implementation directories (like apps/api/src) to their corresponding documentation files (like docs/specs/api) and analyzes the content for mismatches in paths, types, or logic.

Code-Doc Synchronizer

Name: Code-Doc Synchronizer
Author: hibi-com

byhibi-com

0•

Aprendizaje y Documentación

Automatically aligns project documentation with implementation code to ensure technical specifications remain accurate and up-to-date.

The sync-docs skill automates the maintenance of project documentation by auditing implementation code against existing specification files. It identifies discrepancies between actual source code—such as API routes, database schemas, and business logic—and their corresponding documentation in directories like specs, sequence diagrams, and architecture guides. By providing a prioritized list of inconsistencies and offering automated updates, this skill ensures that developers always have a reliable single source of truth, reducing technical debt and onboarding friction caused by outdated docs.

Características Principales

010 GitHub stars

02Validates internal links and command consistency within skill definitions

03Cross-references implementation files with Markdown documentation structures

04Categorizes discrepancies by priority (Critical, Medium, Low)

05Automatically updates documentation to reflect current code implementation

06Supports scoped syncing for API specs, DB schemas, and user stories

Casos de Uso

01Updating API documentation after changing backend routes or validation logic

02Syncing Prisma schema changes with database specification documents

03Ensuring sequence diagrams accurately reflect the current use-case flow in the code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hibi-com/portfolio sync-docs

For use in Claude.ai and ChatGPT

Download Skill