SKILL.md Refactoring Summary

Date: 2025-11-14 Version Change: 1.0.0 → 1.1.0 Skill: agents

Changes Applied

Pattern 2: Converted "## Best Practices" to Imperative Form

Before: "## Best Practices" with subsections containing mixed Do's/Don'ts
After: "## Structure Standards Application" with imperative "When X" format

Keep Root Thin

Before: "Good" and "Bloated" examples with checkmarks/X marks
After: "When creating root AGENTS.md files" with action-oriented instructions
Converted positive examples to directives
Converted negative examples to avoidance instructions

Scope Appropriately

Before: "Create scoped files for:" with bullet list
After: "When determining scope boundaries" with action-oriented guidance
Same content, imperative presentation

Auto-Extract Commands

Before: "Don't manually write commands if they exist in:"
After: "When extracting commands, automate extraction from:"
Positive framing with clear directive

Impact Analysis

Readability: Improved - clearer action-oriented instructions Consistency: Aligned with skill-creator best practices Usability: Enhanced - readers know when and how to apply each pattern Structure: Maintained all examples while improving presentation

Files Modified

/SKILL.md (lines 1-400)

Verification

Version number updated in YAML frontmatter: ✓
Best Practices converted to imperative form: ✓
All guidance remains intact: ✓
No broken internal references: ✓

1.5 KiB Raw Blame History