skill-optimization-guide

What problem does it solve?

Provides a disciplined workflow to condense and reorganize verbose or redundant SKILL.md files so that the entry document becomes a concise, navigable "navigation hub" while preserving all original content in referenced files.

Core Features & Use Cases

• Line-count reduction: Identify SKILL.md files exceeding 200 lines and reduce them by extracting long code examples and detailed specifications into references or samples.
• Duplication elimination: Detect and merge repeated sections into a single "core rules" chapter to minimize overlap and improve readability.
• Safe extraction & linking: Move full implementations to samples, keep skeletons or summaries in references, and insert persistent reference links back into the SKILL.md; includes a verification checklist to ensure no information loss.
• Use Case: When a skill package contains repeated rules and inline templates, apply this guide to produce an entry SKILL.md under 200 lines with all full examples relocated to references and samples.

Quick Start

Run a targeted optimization: reduce SKILL.md to under 200 lines, extract full code blocks into references or samples, and add in-place reference links for every extracted section.