Does this skill support automatic code-to-doc syncing?

Yes, the 'sync' action analyzes your source code (defaulting to the src/ directory) and identifies sections where documentation is missing, outdated, or reflects removed code.

Will doc-maintain delete files without my permission?

No, when performing cleanup actions to remove stale or duplicate content, the skill is configured to prompt the user for confirmation before any removal takes place.

What is the primary purpose of the doc-maintain skill?

The doc-maintain skill is designed to keep technical documentation (primarily AsciiDoc) in sync with source code, cleanup outdated files, and ensure all metadata and cross-references are valid.

Can I use this for non-AsciiDoc files?

While the skill has specialized validation for .adoc files, it can be applied to directories to manage various documentation assets and general file structures.

Documentation Maintenance & Sync

Name: Documentation Maintenance & Sync
Author: cuioss

bycuioss

•

内容管理

Maintains project documentation by synchronizing with code changes, removing stale content, and refreshing metadata across files.

The doc-maintain skill is a specialized utility for the Plan Marshall orchestration layer that automates the lifecycle of technical documentation within Claude Code. It helps developers maintain a single source of truth by identifying drift between source code and documentation, cleaning up orphaned or duplicate content, and repairing broken cross-references. Whether updating a single AsciiDoc file or performing batch processing on a directory, this skill ensures that project manuals remain accurate, formatted correctly, and free of technical debt.

主要功能

01Metadata and cross-reference validation for consistent formatting

02Automated cleanup of stale content, duplicates, and orphaned files

03Comprehensive reporting on documentation health and applied changes

04Support for single-file targeting or recursive directory batch processing

05Code-to-doc synchronization to detect and report documentation drift

061 GitHub stars

使用场景

01Auditing large documentation folders to remove 'TODO' markers and stale content

02Updating technical manuals immediately after a major code refactor

03Standardizing headers and metadata across an entire project's documentation suite

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cuioss/plan-marshall doc-maintain

For use in Claude.ai and ChatGPT

Download Skill