ticket-writer

Generates implementation-ready delivery tickets with Gherkin acceptance criteria from requirements, PRDs, and specs.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill ticket-writer-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ticket-writer
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/ticket-writer
Command: npx skills add https://github.com/subvisual/the-a-team --skill ticket-writer-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Requirements, bug reports, and PRDs often arrive as unstructured prose that implementing developers or autonomous agents cannot act on directly, causing work to bounce back for clarification. This Skill converts that raw material into structured, testable delivery tickets with explicit scope, dependencies, and verifiable Gherkin acceptance criteria. ## Core Features & Use Cases - Three operating modes: write a single ticket from one request, decompose a larger source (PRD, spec, epic) into a batch of dependency-ordered vertical slices, or produce a pasteable acceptance-criteria block for an existing ticket. - Gherkin acceptance criteria as contract: every ticket carries checklist-style Given/When/Then criteria that an independent reviewer or implementing agent can judge a diff against, with stable issue IDs and explicit dependency metadata. - Acceptance coverage gate: in pipeline batch mode, maps every PRD requirement obligation to a ticket or an explicit outstanding entry and validates the result with a read-only CLI gate before the issues phase completes. - Use Case: Given a gated prd.md and spec.md for a new feature, decompose them into a complete issues.md of tracer-bullet vertical slices — each with immutable IDs, requirement traceability, and testable acceptance criteria — ready for unattended agent implementation. ## Quick Start Ask the agent to decompose the feature's prd.md and spec.md into a batch of implementation-ready tickets with Gherkin acceptance criteria written to issues.md.

Frequently Asked Questions about ticket-writer

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

FAQPage Schema
How do I split a PRD into implementation-ready tickets?▼

Use batch decomposition mode: provide the gated prd.md and spec.md, and the Skill produces a complete issues.md of tracer-bullet vertical slices in dependency order. Each ticket gets an immutable ID, explicit dependencies, requirement traceability, and Gherkin acceptance criteria.

How to write acceptance criteria for an existing ticket?▼

Use AC-only mode with the existing ticket or story text as input. The Skill parses it into a primary job, discrete user outcomes, and failure paths, then outputs a pasteable Gherkin checklist block that drops into an Acceptance Criteria section without editing.

What makes a ticket ready for an autonomous coding agent?▼

Agent-ready tickets carry explicit scope, observable Given/When/Then acceptance criteria, declared dependencies by issue ID, expected files touched, and traced PRD requirement IDs. Nothing is implied, since the implementing session and independent reviewer have no conversation context.

When should I not use a ticket writing skill?▼

Do not use it for writing a full PRD, planning discovery, structuring epics, or defining Jobs to be Done — those belong to dedicated upstream skills. Also avoid it when inputs are too vague to define a concrete, verifiable ticket; list the missing facts instead.

Why does the issues phase gate reject some decomposed tickets?▼

The gate rejects tickets with empty acceptance criteria, duplicate or unknown issue IDs, unresolved dependency references, cycles, or unmapped acceptance obligations. Every PRD requirement obligation must map to a real ticket or remain an explicit outstanding entry before advancement.