skill-perfection

# Skill Perfection A systematic process for auditing and fixing plugin skills in a single pass. ## Core Principle **Audit + Fix in One Pass**: When you find an issue, fix it immediately, then continue. This eliminates redundant research and multiple iterations. ## Process Overview ``` [Optional Preflight] → Audit+Fix (single pass) → Verify (spot-check) → Report ``` ## Phase 1: Preflight (Optional, Advisory) A Python-based preflight script is bundled for **Python-heavy skills only**. ### When to Use Preflight | Skill Content | Use Preflight? | |---------------|----------------| | Mostly Python code blocks | ✅ Yes | | Mixed Python + other languages | ⚠️ Optional (Python blocks only) | | Non-Python (JS, Rust, Go, etc.) | ❌ Skip, go to Phase 2 | | Skill about the preflight script itself | ❌ Skip (conflict of interest) | ### Running Preflight ```bash uv run python ${SKILL_DIR}/scripts/preflight.py <path-to-skill.md> --no-urls ``` ### Interpreting Results | Result | Action | |--------|--------| | `✅ PASSED` | Good signal. Proceed to Phase 2, trust syntax is valid. | | `❌ FAILED` with clear errors (syntax error at line X) | Fix those specific issues, then proceed to Phase 2. | | `❌ FAILED` with confusing/many errors | **Ignore preflight entirely.** Proceed to Phase 2, let LLM verify. | | Script crashes or hangs | **Ignore preflight entirely.** Proceed to Phase 2. | ### Key Rule: Preflight is Advisory **The preflight script is a helper, not a gatekeeper.** If it produ...