
Jira Ticket Mastery: From Vague Ideas to Executable Work
Transform vague ideas into executable Jira tickets engineers ship with confidence
What You Can Do
You can convert rough product ideas, bug reports, and feature requests into precise, testable Jira tickets with clear acceptance criteria and definitions of done. This skill guides you through structured ticket writing that eliminates ambiguity, reduces back-and-forth with engineers, and ensures work gets completed as intended. You'll save hours of refinement cycles by catching missing details upfront.
Features
Generate testable, measurable acceptance criteria from vague requirements
Pre-built templates for features, bugs, technical debt, and infrastructure work
Guidance on complexity assessment and effort sizing for your team's velocity
Ensure tickets meet your team's DoD standards before assignment
Automatically surface corner cases, error scenarios, and integration points you might miss
Identify blocked tasks and prerequisite work across ticket descriptions
Review tickets against a 15-point quality rubric before submission to Jira
Adapt templates and criteria to your team's tech stack and workflow patterns
Example Output
Feature Ticket Example:
Title: Add OAuth 2.0 support for GitHub authentication
Description:
Currently, users must create passwords to sign up. We need GitHub OAuth to reduce friction and improve security.
Acceptance Criteria:
- [ ] User can click "Sign in with GitHub" on login page
- [ ] GitHub OAuth flow redirects to callback endpoint
- [ ] User profile populates from GitHub: email, name, avatar
- [ ] Existing email accounts can link GitHub without re-signup
- [ ] Session persists across page refresh
- [ ] CSRF token validated on callback
Definition of Done:
- Unit tests cover happy path + error states (network failure, user decline)
- E2E test verifies full sign-in flow
- Documentation updated in API reference
- No console errors in Chrome, Firefox, Safari
Bug Ticket Example:
Title: [BUG] Cart totals don't recalculate after coupon removal
Steps to Reproduce:
1. Add item ($25) to cart
2. Apply 20% off coupon (total shows $20)
3. Remove coupon
4. Subtotal still shows $20; total is incorrect
Expected: Subtotal and total recalculate to $25
Actual: Total remains $20
Impact: Users may attempt checkout with incorrect amounts
Estimated Story Points: 3 (validation + cart recalc logic)
What's Included
- SKILL.md: Full Claude skill with workflows and decision trees
- Jira Ticket Templates: Feature, bug, technical debt, chore, spike templates
- Acceptance Criteria Checklist: Framework for testable, measurable criteria
- Definition of Done Rubric: Team-agnostic DoD template + customization guide
- Story Pointing Guide: Fibonacci scale guidance and complexity assessment
- Common Pitfalls Playbook: 12 mistakes to avoid (ambiguous success criteria, missing edge cases, undescribed dependencies)
- Quality Review Checklist: 15-point validation checklist for tickets before Jira submission
Who It's For
- Product managers writing feature specs and communicating with engineering
- Engineering managers creating sprint work and driving clarity during planning
- Scrum masters ensuring tickets meet team standards before backlog refinement
- Technical leads drafting tickets for architectural changes and infrastructure work
- Individual contributors who need to propose work or document bugs for teammates
Best For
- Sprint planning — Transforming raw ideas into assignment-ready tickets
- Feature specification — Defining acceptance criteria, acceptance tests, and edge cases
- Bug documentation — Capturing reproduction steps, impact, and expected behavior
- Technical debt tickets — Framing refactoring and optimization work in measurable terms
- Cross-team dependency work — Clearly documenting blocking tasks and integration points







