From etcd-druid
Use when writing GitHub issues for etcd-druid, etcd-backup-restore, or etcd-wrapper — generates durable, behavioral issue descriptions with complete acceptance criteria. Use for new issues, not for existing well-formed ones.
How this skill is triggered — by the user, by Claude, or both
Slash command
/etcd-druid:agent-briefThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate GitHub issue descriptions that can be picked up by any contributor or AI agent without additional context.
Generate GitHub issue descriptions that can be picked up by any contributor or AI agent without additional context.
NO ISSUE WITHOUT COMPLETE ACCEPTANCE CRITERIA.
| Rationalization | Why it fails |
|---|---|
| "It's obvious what needs to happen" | Obvious to you right now. Not to someone picking this up in 3 months |
| "I'll clarify in comments later" | Comments get buried. The issue body is the source of truth |
| "The PR will make it clear" | The PR implements ONE interpretation. Acceptance criteria prevent wrong implementations |
| "It's just a small fix" | Small fixes with ambiguous scope become large PRs with review churn |
## Context
<1-3 sentences: what exists today and why it's insufficient>
## Desired Behavior
<Behavioral description using WHEN/THEN format>
- WHEN <trigger/state>
- THEN <observable outcome>
## Acceptance Criteria
- [ ] <Falsifiable criterion 1>
- [ ] <Falsifiable criterion 2>
- [ ] <Falsifiable criterion 3>
## Scope Boundaries
This issue does NOT cover:
- <explicitly excluded thing 1>
- <explicitly excluded thing 2>
## Classification
- Type: bug | enhancement | refactoring
- Repos affected: etcd-druid | etcd-backup-restore | etcd-wrapper
- Breaking change: yes | no
- Test scope: unit | integration | e2e
| Bad Pattern | Why It Fails | Fix |
|---|---|---|
| "Fix the snapshot issue" | Which issue? No reproduction, no criteria | Add WHEN/THEN + acceptance criteria |
| "Refactor compactor.go" | File-path based, no behavioral goal | Describe the behavioral improvement |
| "Add error handling" | Where? For what? How much? | "WHEN X fails, THEN Y is returned with Z message" |
| "Similar to PR #123" | Requires reading another PR for context | Self-contained description |
| Acceptance criteria: "works correctly" | Not falsifiable | "returns StatusCondition Ready=True within 30s" |
gh issue createAlways include at least 2 "does NOT cover" items. Common boundaries:
/etcd-druid:plan for implementation/etcd-druid:debugnpx claudepluginhub seshachalam-yv/etcd-druid-skills --plugin etcd-druid-skillsGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.