Skip to content

rampstackco/claude-skills / skills/ticket-authoring

ticket-authoring

Verified

Write complete, ready-to-pull work items for an issue tracker: bugs, tasks, stories, spikes, and epics, each with the fields, attachments, and done test its type requires. Use this skill whenever the user wants to write a ticket, create a Jira issue, Linear issue, or GitHub issue, file a bug report, write a user story or acceptance criteria, scope a spike, open an epic, or break work into tasks. Triggers on write a ticket, create an issue, file a bug, bug report, user story, spike, epic, task breakdown, turn this into tickets, break this down, acceptance criteria, definition of ready, ready for dev, backlog item, capitalization stage. Also triggers when the user pastes a PRD, a spec, or a bug description and asks what to do with it, even if they never say the word ticket.

references/spike-template.md

View on GitHub
# Spike Template

A spike spends a fixed amount of time to answer one question. Its deliverable is a decision memo with a recommendation. "We looked into it" is not a deliverable.

---

## Template

```
TITLE: Spike: [the question, shortened]

TYPE: Spike
OWNER: [one name]
PARENT: [epic or story the answer unblocks]
LABELS: [component, research]
CAPITALIZATION STAGE: [preliminary, by default; override with a note]

QUESTION
[One sentence ending in a question mark.]

WHY NOW
[What decision is blocked until this is answered.]

TIMEBOX
[N working days. Start date. Hard stop date.]

EXIT CRITERIA
[What counts as an answer. Example: "A recommendation between options A, B, and C, with cost at 10x current volume and one known risk per option."]

RESOURCES TO EVALUATE
- Services or platforms: [list]
- Internal systems: [list]
- Documentation or standards: [list]

COMPETITOR OR PRIOR-ART EXAMPLES
- [Example and what to look at, or none]

OUT OF SCOPE
- [What the spike will not investigate]

OUTPUT ARTIFACT
Decision memo at [location], using the shape below.
```

---

## Decision memo shape

```
# Decision memo: [question]

Date: [YYYY-MM-DD]
Author: [name]
Timebox used: [N of M days]

## Recommendation
[One paragraph. What to do and why.]

## Options considered
| Option | Fit | Cost | Risk | Notes |
|---|---|---|---|---|

## Evidence
[What was tested, measured, or read. Links.]

## Still unknown
[What the timebox did not answer, and what it would take to answer it.]

## Follow-up tickets
- [Ticket to create if the recommendation is accepted]
```

---

## Timebox rules

- A spike gets days, not "until we know." One to five days covers most spikes.
- When the timebox ends, the memo ships with whatever is known. "Still unknown" is a valid section.
- Extending a spike is a new decision, made in refinement, with a reason. It is not automatic.

---

## Good and bad spike questions

| Weak | Strong |
|---|---|
| Look into search | Can the current database's full-text search return results under 1 second for 1M records, or do we need a separate search service? |
| Research payment providers | Which of three payment providers supports split payouts in our five launch countries at under 3 percent total fees? |
| Investigate flaky tests | What are the top three causes of the 40 test failures that passed on retry last month? |
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall