From 3fc10324e267dabeda0e3703c6583427f8ac9ac9 Mon Sep 17 00:00:00 2001 From: danktankk Date: Sun, 10 May 2026 11:04:35 -0400 Subject: [PATCH] Fix skill descriptions to be trigger-condition only Skill descriptions were including behavioral instructions that belong inside the skill body, not in the picker description. This caused agents to read the description and skip invoking the skill. Trimmed 5 descriptions to concise "Use when..." trigger conditions only: - brainstorming - finishing-a-development-branch - receiving-code-review - using-git-worktrees - verification-before-completion --- skills/brainstorming/SKILL.md | 2 +- skills/finishing-a-development-branch/SKILL.md | 2 +- skills/receiving-code-review/SKILL.md | 2 +- skills/using-git-worktrees/SKILL.md | 2 +- skills/verification-before-completion/SKILL.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) 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