Ticket
npx machina-cli add skill jackhendon/pm-skills/ticket --openclawYou are helping a product manager write a well-structured product ticket ready to paste into Notion.
Start by sending this message -- exactly as written, no preamble:
I'll help you draft a product ticket. Answer these four questions and I'll produce a formatted draft ready to paste into Notion.
- What is the feature, bug, or task? Give me a clear, plain-English description.
- Why are we doing this? What user or business problem does it solve?
- Any specific requirements, constraints, or edge cases? Include anything the engineer needs to know.
- Any context to include? Figma links, related tickets, dependencies, screenshots.
After the user responds, generate a complete ticket using the template below. Apply the writing rules strictly.
Output format
## Summary
[1-2 sentences. What the work is. No jargon, no implementation detail.]
## Why?
[The user or business problem. Not implementation rationale.]
## Requirements
[Grouped by area if complex. Descriptive, not prescriptive. What needs to be true, not how to build it.]
## Acceptance Criteria
- [ ] [Testable outcome]
- [ ] [Testable outcome]
- [ ] [Testable outcome]
## Context / Other Info
[Figma links, related tickets, screenshots, dependencies, notes]
Writing rules
Summary
- 1-2 sentences maximum
- Describes what the work is, not how it will be built
- No jargon, acronyms unexplained, or implementation detail
Why?
- States the user or business problem being solved
- Not "because the engineer wants to refactor" -- the underlying need
- If the user gave metrics or data, include them
Requirements
- Group related items if there are more than 4-5 lines
- Descriptive and outcome-oriented, not step-by-step instructions
- Edge cases and constraints go here if the user provided them
Acceptance Criteria
- Every item must be independently testable by a QA engineer or stakeholder
- Written as checks ("A user can...", "The system does...", "X does not happen when...")
- Not feature descriptions -- testable outcomes only
- Minimum 3 items
- Use
- [ ]checkboxes (Notion-compatible)
Context / Other Info
- Include everything the user provided verbatim (links, ticket numbers, notes)
- If the user provided nothing, include these placeholder lines:
Figma: [add link]Related tickets: [add links]Screenshots: [add if relevant]
General
- Do not pad or invent content
- If information was not given, use a placeholder rather than guessing
- Keep language plain and professional
After generating the ticket
Ask: "Does this look right, or would you like to adjust anything?"
If the user requests changes, apply them and output the full updated ticket. Do not ask a second round of refinement questions -- one revision pass only.
Source
git clone https://github.com/jackhendon/pm-skills/blob/main/.claude/skills/ticket/SKILL.mdView on GitHub Overview
This skill helps product managers draft complete, Notion-ready tickets. It starts with a short requirements-gathering conversation and outputs a structured draft ready to paste into Notion.
How This Skill Works
It begins by asking four questions to capture feature, problem, constraints, and context. It then fills a Notion ticket template with sections for Summary, Why, Requirements, Acceptance Criteria, and Context, producing a ready-to-paste draft.
When to Use It
- Starting a new feature ticket and needing a complete, Notion-ready draft
- Clarifying scope with stakeholders via guided questions
- Capturing edge cases, constraints, and dependencies in one place
- Preparing tickets to paste into Notion for project tracking
- Maintaining a consistent, template-based ticket format across teams
Quick Start
- Step 1: Start the Q&A by sending the exact four-question prompt
- Step 2: Provide clear, complete answers to gather requirements
- Step 3: Paste the generated Notion-ready ticket into Notion and adjust as needed
Best Practices
- Provide a clear, plain-English description of the feature, bug, or task
- Answer all four questions with user or business context
- Include edge cases, constraints, and dependencies in Requirements
- Keep the Summary concise and free of implementation details
- Use the Context / Other Info field to preserve links and references
Example Use Cases
- Feature: Add dark mode with accessible contrast and keyboard shortcuts
- Bug: Checkout total incorrect when applying a promo code
- Task: Update onboarding screens to reflect revised pricing
- Feature: Multi-language support for product pages
- Task: Migrate legacy tickets to the Notion template