skill-enhancer

# Skill Enhancer **Purpose**: This meta-skill analyzes other skills for compliance with TDD, CSO, and Script-First standards, guiding the agent through upgrades. ## 1. Red Flags (Anti-Rationalization) **STOP and READ THIS if you are thinking:** - "I'll just add the sections blindly" -> **WRONG**. You must understand *why* the skill fails before fixing it. - "The description is close enough" -> **WRONG**. It must start with "Use when". - "Examples are optional" -> **WRONG**. "Rich Skills" mandate examples. - "It's just a small 20-line example" -> **WRONG**. Inline blocks > 12 lines are prohibited. Extract them. - "I'll instruct the agent to parse the file line-by-line in text" -> **WRONG**. Use "Script-First". ## 2. Capabilities - **Audit**: Detect gaps (missing Red Flags, inline blocks > 12 lines, poor CSO, weak language) using `analyze_gaps.py`. - **Execution Policy Audit**: Detect missing `Execution Mode`, `Script Contract`, `Safety Boundaries`, and `Validation Evidence` sections. - **Security Remediation**: Fix vulnerabilities flagged by `skill-validator` (e.g., `curl | bash`, secrets, weak permissions). - **Plan**: Propose specific content improvements using `references/refactoring_patterns.md`. - **Execute**: Apply refactoring patterns to upgrade the skill. ## 2.5. Execution Mode - **Mode**: `hybrid` - **Rationale**: gap triage and refactoring decisions are prompt-driven, while gap detection is script-driven. ## 2.6. Script Contract - **Primary Command**: `python3 s...