writing-tickets

Create and refine software tickets with Given/When/Then acceptance criteria.

3|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/jon23d/skillz --skill writing-tickets-jon23d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-tickets
Source: https://github.com/jon23d/skillz/tree/main/skills/writing-tickets
Command: npx skills add https://github.com/jon23d/skillz --skill writing-tickets-jon23d

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you write, review, and improve software tickets, user stories, or issue descriptions by ensuring they have clear requirements, acceptance criteria, and defined scope boundaries.

Core Features & Use Cases

  • User Story Formulation: Guides you to write effective user stories using the "As a [persona], when I [context/trigger], I want to [action] so that [benefit]" format.
  • Acceptance Criteria Definition: Helps create testable criteria using the "Given / When / Then" structure, covering happy paths and edge cases.
  • Scope Management: Emphasizes the importance of an "Out of Scope" section to prevent misunderstandings and scope creep.
  • Use Case: A product manager needs to create a new ticket for a feature request. They use this Skill to ensure the ticket clearly defines the user, the desired action, the expected outcome, and how to verify its completion, while also explicitly stating what is not included.

Quick Start

Use the writing-tickets skill to draft a user story for a new login feature.

Frequently Asked Questions about writing-tickets

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

FAQPage Schema
How do I write a user story with clear acceptance criteria for a new feature?

Writing user stories requires defining the persona, context, and desired action, while acceptance criteria should use the Given/When/Then structure to cover happy paths and edge cases, ensuring the feature is fully testable and verifiable.

What is the best way to define out-of-scope boundaries in issue descriptions?

Defining out-of-scope boundaries in issue descriptions involves explicitly stating what is excluded from the ticket to prevent scope creep and misunderstandings, ensuring developers focus only on the specified requirements and verifiable acceptance criteria.

How do you format acceptance criteria using Given When Then for edge cases?

Formatting acceptance criteria using Given When Then involves specifying a starting state (Given), an action trigger (When), and the expected outcome (Then), effectively covering both happy paths and edge cases to ensure software ticket clarity and completeness.

Can I use this approach to review and improve existing software tickets?

Yes, you can review and improve existing software tickets by checking for clear user story formulation, verifying that acceptance criteria are testable, and ensuring explicit out-of-scope boundaries are defined to prevent scope creep during development cycles.

Why do I need an out of scope section in user stories?

An out of scope section is needed in user stories to prevent misunderstandings and scope creep by explicitly defining what features, actions, or requirements are excluded, keeping the development cycle efficient and focused.

What should be included in software development tickets to ensure efficient development cycles?

Software development tickets should include clear user stories, verifiable acceptance criteria using Given/When/Then, and explicit out-of-scope boundaries to ensure ticket clarity and completeness for efficient development cycles.