refactor: convert passive voice to imperative form in skill content

[sjnims]

Summary

Per the skill-development best practices, SKILL.md body content should use imperative/infinitive form, not passive voice or second person. Several skills contain passive constructions that should be converted.

Writing Style Requirements

From skill-development skill:

Writing Style: Write the entire skill using imperative/infinitive form (verb-first instructions), not second person. Use objective, instructional language (e.g., "To accomplish X, do Y" rather than "You should do X" or "If you need to do X").

Examples of Required Conversions

Passive → Imperative

Current (Passive)	Correct (Imperative)
"Understanding agent structure enables creating..."	"To create agents effectively, understand the structure..."
"This allows you to..."	"Use this to..."
"Hooks are loaded when..."	"Claude Code loads hooks when..."
"This provides..."	"Use this pattern to..."
"You can configure..."	"Configure..."

Second Person → Imperative

Current (Second Person)	Correct (Imperative)
"You should validate inputs"	"Validate inputs"
"You need to check..."	"Check..."
"If you want to..."	"To [goal]..."

Skills to Review

All skills should be audited, but these have notable instances:

• agent-development - "Understanding agent structure enables creating..."
• command-development - Mixed styles in explanatory sections
• hook-development - Some passive in lifecycle section
• mcp-integration - "This allows..." patterns
• plugin-structure - Generally good, minor polish
• plugin-settings - Some "you can" patterns
• skill-development - Should be exemplary as meta-skill

Acceptance Criteria

• All "Understanding X enables Y" → "To Y, understand X"
• All "This allows you to..." → "Use this to..."
• All "You should/need/can..." → Direct imperative
• Skills read naturally with consistent voice
• No second-person pronouns in instructional content

Priority

Low - Polish task that improves consistency but doesn't affect functionality.

[github-actions]

👋 Thanks for opening your first issue! We appreciate your contribution to plugin-dev.

Please make sure you've provided all the requested information in the issue template. Our maintainers will review this soon.

[sjnims]

PR submitted: #8