ticket-refinement

Transform user stories into structured subtask write-ups with QA checklists.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/guidodinello/claude-dotfiles --skill ticket-refinement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ticket-refinement
Source: https://github.com/guidodinello/claude-dotfiles/tree/main/.claude/skills/ticket-refinement
Command: npx skills add https://github.com/guidodinello/claude-dotfiles --skill ticket-refinement

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts vague user stories or ticket descriptions into structured, actionable subtasks for developers, QA, and product planning, reducing ambiguity and speeding up delivery.

Core Features & Use Cases

  • Subtask extraction: turns a narrative into concrete deliverables (Context, What Needs to Be Built, Edge Cases, Open Questions) for engineering and QA.
  • Clarifying questions: suggests upfront questions to align scope and expectations before implementation.
  • Output consistency: produces a standardized template that can be handed to engineers and QA for implementation.

Quick Start

Provide a user story or ticket description to generate a structured subtask write-up.

Frequently Asked Questions about ticket-refinement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a vague user story into actionable subtasks for development and QA?

To turn a vague user story into actionable subtasks, you provide the narrative to a refinement tool that extracts concrete deliverables, edge cases, and open questions into a structured template for engineering and QA teams.

What is the best way to structure ticket descriptions for backend endpoints and frontend components?

The best way to structure ticket descriptions for backend and frontend components is to use a standardized template covering Context, What Needs to Be Built, Edge Cases, Open Questions, and a QA-ready checklist to ensure consistent scope and deliverables.

How does subtask extraction from a user story help product planning?

Subtask extraction from a user story helps product planning by converting ambiguous requirements into a structured write-up, reducing ambiguity, clarifying scope upfront, and speeding up delivery for developers and QA.

Can I generate a QA-ready checklist directly from a ticket description?

Yes, you can generate a QA-ready checklist directly from a ticket description. The refinement process transforms the narrative into structured sections including edge cases and a checklist for QA to verify implementation.

What should be included in ticket refinement to align scope and expectations before implementation?

Ticket refinement to align scope and expectations should include clarifying questions, context, what needs to be built, edge cases, and open questions. This structured approach ensures developers and QA understand deliverables before implementation.

Does ticket refinement work for API integrations and data flows?

Yes, ticket refinement works for API integrations and data flows. The process applies to these technical scopes to refine deliverables and produce a consistent, actionable template for development and product teams.