skill-simplify

What problem does it solve?

It reduces redundancy and fixes formatting in a skill’s SKILL.md while guaranteeing functional integrity so the skill continues to behave the same way.

Core Features & Use Cases

• Functional-first simplification: Preserves functional elements such as logic code blocks, agent calls, data structures, routing branches, and schemas while removing only safely deletable descriptive content.
• Three-phase workflow: Runs an analysis phase to build a functional inventory, an optimization phase to apply deletion/merge/simplify/format rules, and an integrity check phase to verify counts and detect any losses.
• Pseudo-code validation: Detects format issues like nested backticks, bracket mismatches, and structural completeness problems, then fixes them during optimization.
• Quantitative integrity verification: Compares functional inventory baselines before vs. after, failing on critical functional loss and warning when only safe/expected decreases occur.

Quick Start

Use the skill-simplify skill to simplify a target SKILL.md by running it on the file path you want to optimize and then confirm the Phase 3 integrity check passes.