Debugging Skill Files

When a skill file isn't working as expected — agents misapply it, users give negative feedback, or the skill produces incorrect results — you need a systematic debugging approach. This skill covers diagnosing and fixing the most common skill file issues: from formatting problems that break parsing to subtle instruction ambiguities that lead agents astray.

## Key Points

1. "Agent ignores the skill entirely"
2. "Agent applies the skill to wrong situations"
3. "Agent follows instructions but produces wrong output"
4. "Agent only partially follows the skill"
5. "Agent adds things not in the skill"
1. Identify the specific failure
2. Isolate the skill
3. Test the exact version
4. Document the reproduction steps
1. Make the minimum change that fixes the issue
2. Test the fix against the reproduction case
3. Test for regressions