Skip to content

Commit 61b1ea6

Browse files
sjnimsclaude
andauthored
refactor: convert passive voice to imperative form in skill content (#8)
## Summary - Convert "Understanding X enables creating Y" passive constructions to imperative "Master X to create Y" form - Replace second-person possessive "your" with definite article "the" in template examples - Ensure consistent instructional voice across all skill content ## Problem Fixes #4 Per the skill-development best practices, SKILL.md body content should use **imperative/infinitive form**, not passive voice or second person. Several skills contained passive constructions and second-person pronouns that needed conversion. ## Solution Applied consistent imperative voice conversions following these patterns: | Pattern | Before | After | |---------|--------|-------| | Passive gerund | "Understanding X enables creating Y" | "Master X to create Y" | | Second-person possessive | "in your project" | "in the project" | | Second-person possessive | "Your settings" | "Settings" | ## Changes - `agent-development/SKILL.md`: Line 11 - passive to imperative - `command-development/SKILL.md`: Line 11 - passive to imperative - `plugin-structure/SKILL.md`: Line 11 - passive to imperative - `plugin-settings/SKILL.md`: Lines 296, 307, 371 - second-person to definite article ## Testing - [x] All changes follow imperative/infinitive form - [x] Markdown linting passes - [x] Skills read naturally with consistent voice - [x] No second-person pronouns in instructional content --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>
1 parent a14e9a6 commit 61b1ea6

4 files changed

Lines changed: 6 additions & 6 deletions

File tree

plugins/plugin-dev/skills/agent-development/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ version: 0.1.0
88

99
## Overview
1010

11-
Agents are autonomous subprocesses that handle complex, multi-step tasks independently. Understanding agent structure, triggering conditions, and system prompt design enables creating powerful autonomous capabilities.
11+
Agents are autonomous subprocesses that handle complex, multi-step tasks independently. Master agent structure, triggering conditions, and system prompt design to create powerful autonomous capabilities.
1212

1313
**Key concepts:**
1414
- Agents are FOR autonomous work, commands are FOR user-initiated actions

plugins/plugin-dev/skills/command-development/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ version: 0.1.0
88

99
## Overview
1010

11-
Slash commands are frequently-used prompts defined as Markdown files that Claude executes during interactive sessions. Understanding command structure, frontmatter options, and dynamic features enables creating powerful, reusable workflows.
11+
Slash commands are frequently-used prompts defined as Markdown files that Claude executes during interactive sessions. Master command structure, frontmatter options, and dynamic features to create powerful, reusable workflows.
1212

1313
**Key concepts:**
1414

plugins/plugin-dev/skills/plugin-settings/SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -293,7 +293,7 @@ Provide template in plugin README:
293293
```markdown
294294
## Configuration
295295

296-
Create `.claude/my-plugin.local.md` in your project:
296+
Create `.claude/my-plugin.local.md` in the project:
297297

298298
\`\`\`markdown
299299
---
@@ -304,7 +304,7 @@ max_retries: 3
304304

305305
# Plugin Configuration
306306

307-
Your settings are active.
307+
Settings are active.
308308
\`\`\`
309309

310310
After creating or editing, restart Claude Code for changes to take effect.
@@ -368,7 +368,7 @@ fi
368368

369369
**Important:** Settings changes require Claude Code restart.
370370

371-
Document in your README:
371+
Document in the plugin README:
372372

373373
```markdown
374374
## Changing Settings

plugins/plugin-dev/skills/plugin-structure/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ version: 0.1.0
88

99
## Overview
1010

11-
Claude Code plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Claude Code.
11+
Claude Code plugins follow a standardized directory structure with automatic component discovery. Master this structure to create well-organized, maintainable plugins that integrate seamlessly with Claude Code.
1212

1313
**Key concepts:**
1414

0 commit comments

Comments
 (0)