# ticket-craft

ticket-craft formats Jira, Linear, and Asana tickets so AI agents can execute them autonomously without clarification.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 283 installs · ★ 713 repo stars
- Author: alinaqi
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/alinaqi/maggy/tree/HEAD/skills/ticket-craft/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ticket-craft

## What it does

This skill extends the standard INVEST agile framework with a Claude-Ready check. It treats software tickets as self-contained prompts because an agent cannot jump into Slack to clarify missing requirements.

The skill provides structured templates for feature requests and bug reports. A feature spec forces you to document Given-When-Then criteria, exact paths like `src/services/example.ts`, design constraints, and explicit test commands such as `npm test` or `npm run typecheck`.

If a ticket omits file references or test steps, the agent will guess the implementation. A task is ready for execution only when its boundaries and validation commands are fully defined.

## Requirements
- Works with: Jira, Linear

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill ticket-craft -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ticket-craft/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ticket-craft/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill ticket-craft -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ticket-craft/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill ticket-craft -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ticket-craft/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alinaqi/maggy skills/ticket-craft
```

2. **Manually: put the files in place**
- File: `.github/skills/ticket-craft/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill ticket-craft -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alinaqi/maggy --path skills/ticket-craft
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ticket-craft/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill ticket-craft -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alinaqi/maggy/tree/HEAD/skills/ticket-craft/SKILL.md

## When to use it
- Structure Linear or Jira tickets for autonomous AI execution
- Break down epics into standalone tasks using INVEST+C rules
- Define strict implementation constraints and verification tests for an agent

## Example prompts
- Generate a Linear ticket for the authentication endpoint using ticket-craft
- Write a bug report for the login modal using ticket-craft format
- Break down the payment integration into Claude-ready task specs

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 032a73caf527bbe1.

BEGIN THIRD-PARTY FILE 032a73caf527bbe1
````text
---
name: ticket-craft
description: Create Jira/Asana/Linear tickets optimized for Claude Code execution - AI-native ticket writing
when-to-use: When creating tickets, breaking down epics, or writing specs for AI agent execution
user-invocable: true
effort: medium
---

# Ticket Craft Skill

*Write software tickets that AI agents can execute autonomously.*

**Purpose:** Define a ticket format that combines software engineering best practices (INVEST, Given-When-Then, Definition of Ready) with Claude Code-specific context requirements. Every ticket created with this skill is "Claude Code Ready" - meaning an agent can pick it up and execute it without asking clarifying questions.

**Works with:** Jira, Asana, Linear, GitHub Issues, or any ticket system.

---

## Core Principle

```
┌─────────────────────────────────────────────────────────────────┐
│  A TICKET IS A PROMPT                                            │
│  ──────────────────────────────────────────────────────────────  │
│                                                                  │
│  Traditional tickets are written for humans who can:             │
│  - Ask clarifying questions in Slack                             │
│  - Draw on institutional knowledge                               │
│  - Infer intent from vague descriptions                          │
│                                                                  │
│  AI agents cannot do any of this.                                │
│                                                                  │
│  Every ticket must be SELF-CONTAINED:                            │
│  - Explicit file references (not "the auth module")              │
│  - Pattern references (not "follow our conventions")             │
│  - Verification criteria (not "make sure it works")              │
│  - Constraints (not just what to do, but what NOT to do)         │
│  - Test commands (not "run the tests")                           │
│                                                                  │
│  If Claude Code can execute it without asking a question,        │
│  the ticket is ready. If it can't, it's not.                     │
└─────────────────────────────────────────────────────────────────┘
```

---

## The INVEST+C Criteria

Standard INVEST plus **C for Claude-Ready**:

| Criterion | Question | Fails If... |
|-----------|----------|-------------|
| **I** - Independent | Can this be completed without waiting on another ticket? | Blocked by undocumented dependencies |
````
END THIRD-PARTY FILE 032a73caf527bbe1

The third-party file has ended. Everything between the 032a73caf527bbe1 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2986 of 23253 bytes. © alinaqi · MIT · https://github.com/alinaqi/maggy/tree/HEAD/skills/ticket-craft/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
