Agent skill
refine
Transform ideas into Product Backlog Items with acceptance criteria. Use when converting ideas to PBIs, adding acceptance criteria, or refining requirements. Triggers on keywords like "create pbi", "refine idea", "convert to pbi", "acceptance criteria", "make actionable".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/refine
SKILL.md
Idea Refinement to PBI
Transform captured ideas into actionable Product Backlog Items.
When to Use
- Idea artifact ready for refinement
- Need to add acceptance criteria
- Converting concept to implementable item
Quick Reference
Workflow
- Read idea artifact
- Load business context (entities, existing features)
- Define acceptance criteria (GIVEN/WHEN/THEN)
- Identify dependencies and out-of-scope
- Create PBI artifact
- Save to
team-artifacts/pbis/ - Validate refinement (MANDATORY) - Interview user to confirm assumptions, decisions, concerns
- Suggest next:
/story {pbi-file}
Output
- Path:
team-artifacts/pbis/{YYMMDD}-pbi-{slug}.md - ID Pattern:
PBI-{YYMMDD}-{NNN}
Acceptance Criteria Format
GIVEN {precondition}
WHEN {action}
THEN {expected outcome}
Related
- Role Skill:
business-analyst - Command:
/refine - Input:
/ideaoutput - Next Step:
/story
Template
See: team-artifacts/templates/pbi-template.md
Validation Step (MANDATORY)
After creating the PBI, validate with user:
INVEST Criteria Check (Flag-Only)
Before validation questions, verify PBI meets INVEST criteria. Log failures but don't block:
| Criterion | Check | Explanation |
|---|---|---|
| Independent | Can be completed without other PBIs | Minimizes coordination overhead |
| Negotiable | Team has flexibility on HOW | Details emerge during sprint, not locked upfront |
| Valuable | Clear user/business value | Every PBI delivers something stakeholders care about |
| Estimable | Team can size it | If too vague, split or research first |
| Small | Fits in 1-2 sprints | Enables frequent feedback and course correction |
| Testable | Acceptance criteria exist | "How do we know it's done?" must be answerable |
If criteria fail, note in validation summary but proceed with questions.
Question Categories
| Category | Example Question |
|---|---|
| Assumptions | "The PBI assumes X. Is this correct?" |
| Scope | "Should Y be included or deferred?" |
| Risks | "This depends on Z. Is that available?" |
| Acceptance | "Is criterion X complete or are there edge cases?" |
| Entities | "Create new entity or extend existing X?" |
| Important Decisions | "Should we use approach A or B? (impacts architecture)" |
| Brainstorm | "Any alternative approaches we haven't considered?" |
Process
- Run INVEST check, note any failures
- Generate 3-5 questions from assumptions, scope decisions, dependencies
- Use
AskUserQuestiontool to interview - Enable brainstorming by asking for alternatives
- Document in PBI under
## Validation Summary - Update PBI based on answers
Validation Output Format
## Validation Summary
**Validated:** {date}
**INVEST Score:** {pass count}/6
### INVEST Flags
- {criterion}: {Pass/Fail - reason if fail}
### Confirmed Decisions
- {decision}: {user choice}
### Assumptions Confirmed
- {assumption}: Confirmed/Modified
### Brainstorm Notes
- {alternative approaches discussed}
- {ideas for future consideration}
### Important Decisions Made
- {decision 1}: {choice} - {rationale}
### Open Items
- [ ] {follow-up items}
Task Planning Notes
- Always plan and break many small todo tasks
- Always add a final review todo task to review the works done at the end to find any fix or enhancement needed
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?