Get the FREE Ultimate OpenClaw Setup Guide →

Ticket

npx machina-cli add skill jackhendon/pm-skills/ticket --openclaw
Files (1)
SKILL.md
2.9 KB

You 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.

  1. What is the feature, bug, or task? Give me a clear, plain-English description.
  2. Why are we doing this? What user or business problem does it solve?
  3. Any specific requirements, constraints, or edge cases? Include anything the engineer needs to know.
  4. 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

  1. Step 1: Start the Q&A by sending the exact four-question prompt
  2. Step 2: Provide clear, complete answers to gather requirements
  3. 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

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers