Can it delete files automatically?

No, the skill always presents an optimization report and requires explicit user confirmation before deleting, moving, or modifying any files.

Does this skill work with any documentation folder?

While optimized for the Katachi framework structure (feature-specs, architecture, etc.), it can be scoped to specific files or directories to analyze standard Markdown documentation.

What happens if an optimization removes important data?

The skill includes a validation step that uses git to compare original and optimized versions, automatically correcting or flagging any accidental data loss.

How does it decide when a document is too long?

It follows specific heuristics, such as flagging feature specs over 400 lines or architectural decisions over 150 lines, as candidates for splitting.

Is the Katachi framework required?

The skill checks for a Katachi initialization (docs/planning/) to function correctly, as it relies on specific template references for structural analysis.

Optimize Documentation

Name: Optimize Documentation
Author: asermax

byasermax

•

학습 및 문서화

Analyzes and refactors project documentation by identifying opportunities to split long files, reduce verbosity, and remove obsolete content.

The optimize-docs skill is a specialized tool for the Katachi framework designed to maintain high-quality, manageable project documentation. It intelligently scans feature specifications, designs, and architecture decisions to detect structural non-compliance, redundant phrasing, and oversized documents that hinder readability. By automating the discovery process and providing a guided workflow for refactoring, it ensures your technical docs remain lean and searchable, while leveraging git-based validation to prevent any data loss during the optimization process.

주요 기능

01Identification of orphaned files and superseded architectural decisions

02Detection of repetitive phrasing and redundant over-explanations

03Git-integrated validation to ensure no content is lost during refactoring

04Automated identification of oversized documents for logical splitting

051 GitHub stars

06Structural compliance checks against standard Katachi templates

사용 사례

01Auditing project documentation for structural consistency and technical debt

02Cleaning up legacy design docs and ADRs during project transitions

03Refactoring massive feature specs into smaller, modular sub-documents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins optimize-docs

For use in Claude.ai and ChatGPT

Download Skill