diff --git a/skills/brainstorming/SKILL.md b/skills/brainstorming/SKILL.md index 06cd0a21ee..17523e2d49 100644 --- a/skills/brainstorming/SKILL.md +++ b/skills/brainstorming/SKILL.md @@ -1,6 +1,6 @@ --- name: brainstorming -description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation." +description: "Use when about to create features, build components, add functionality, or modify behavior -- before any implementation work begins." --- # Brainstorming Ideas Into Designs diff --git a/skills/finishing-a-development-branch/SKILL.md b/skills/finishing-a-development-branch/SKILL.md index 43da0ae169..d4b7323c84 100644 --- a/skills/finishing-a-development-branch/SKILL.md +++ b/skills/finishing-a-development-branch/SKILL.md @@ -1,6 +1,6 @@ --- name: finishing-a-development-branch -description: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup +description: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work. --- # Finishing a Development Branch diff --git a/skills/receiving-code-review/SKILL.md b/skills/receiving-code-review/SKILL.md index 4ea72cdf01..768a227300 100644 --- a/skills/receiving-code-review/SKILL.md +++ b/skills/receiving-code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: receiving-code-review -description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation +description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable. --- # Code Review Reception diff --git a/skills/using-git-worktrees/SKILL.md b/skills/using-git-worktrees/SKILL.md index 134d37140b..fa8011d0bf 100644 --- a/skills/using-git-worktrees/SKILL.md +++ b/skills/using-git-worktrees/SKILL.md @@ -1,6 +1,6 @@ --- name: using-git-worktrees -description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback +description: Use when starting feature work that needs isolation from the current workspace, or before executing implementation plans that should not affect the main working tree. --- # Using Git Worktrees diff --git a/skills/verification-before-completion/SKILL.md b/skills/verification-before-completion/SKILL.md index 2f14076e59..d7ad599604 100644 --- a/skills/verification-before-completion/SKILL.md +++ b/skills/verification-before-completion/SKILL.md @@ -1,6 +1,6 @@ --- name: verification-before-completion -description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always +description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs. --- # Verification Before Completion