use-case-writing

Write formal Cockburn-style use cases with actors, preconditions, and structured flows.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill use-case-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-case-writing
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/use-case-writing/skills/use-case-writing
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill use-case-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write formal UML-inspired use cases that capture goals, actors, preconditions, postconditions, triggers, and structured flows, enabling precise specifications and testable expectations.

Core Features & Use Cases

  • Goal-oriented, verb-led use cases (e.g., "Place Order")
  • Actor-centric perspective focusing on primary and supporting roles
  • Main Success Scenario with numbered steps
  • Alternate and exception flows with clear divergence points
  • Fully-dressed templates for critical flows; casual formats for early exploration
  • Phase-guided approach covering setup, format selection, level classification, and diagram relationships

Quick Start

Draft a fully-dressed use case for a user login flow, including actors, preconditions, main success scenario steps, alternate and exception flows, and postconditions.

Frequently Asked Questions about use-case-writing

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

FAQPage Schema
How do I write a formal use case with a Main Success Scenario and alternate flows?

A fully-dressed use case includes actors, preconditions, triggers, a Main Success Scenario with numbered steps, and alternate or exception flows. This format captures how actors interact with a system to achieve specific goals, providing precise and testable expectations.

What is the Cockburn style format for use case specifications?

The Cockburn style format structures use cases by focusing on primary and supporting actors, goal-oriented verb-led titles, and fully-dressed templates. It enforces rules for main scenario steps, alternates, exceptions, and relationships to capture precise system interactions.

When should I use fully-dressed use cases versus casual formats?

Use fully-dressed use cases for critical flows requiring precise specifications and testable expectations, including preconditions, postconditions, and triggers. Use casual formats for early exploration when you need to quickly draft how actors interact with a system without full structural detail.

How do I structure preconditions and postconditions in UML use cases?

Structure preconditions and postconditions within a fully-dressed template alongside the Main Success Scenario. Preconditions define the required state before triggers activate the flow, while postconditions specify the guaranteed system state after the goal is achieved or exceptions occur.

Does this approach support use case elicitation and level classification?

Yes, the approach supports use case elicitation and level classification through a phase-guided process. It covers setup, format selection, level classification, and diagram relationships to ensure the use case accurately describes how actors interact with a system.

What are the limitations of using Cockburn-style use cases for requirements validation?

Cockburn-style use cases enforce a strict structured template for main scenario steps, alternates, and exceptions, which may introduce overhead for early exploration. Casual formats are recommended initially, reserving fully-dressed templates for critical flows requiring precise specifications.