Write Brd
digoal/blog
Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity.
Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .claude/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .agents/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .cursor/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .gemini/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .github/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install phucnt-bazone-vietnam/use-case-writer use-case-writer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "use-case-writer" agent skill from https://github.com/phucnt-bazone-vietnam/use-case-writer/tree/main into .opencode/skills/use-case-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-case-writer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
use-case-writerGenerate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).
Use Case Writer is an agent skill from phucnt-bazone-vietnam/use-case-writer. Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA). Use whenever a BA needs to scope, analyze, document, refine, or review a Use Case. Triggers include "write a use case", "draft UC", "use case specification", "analyze UC scope", "split feature into use cases", "review my UC", "write normal course / alternative course / exceptions", "define actors", and Vietnamese equivalents like "viết use case", "viết UC", "đặc tả use case", "phân tích use…
Its SKILL.md is about 4.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files and assets (for example `CHANGELOG.md`, `README.md` and `assets/uc-template.md`).
It sits in Product & Project Management, covering Diagrams, PRD writing and User stories. The repository describes itself as: This Claude AI Skill for Business Analysts & Product Owners, Use Case Writer scope, analyze, and document Use Case Specifications in English Markdown following the 13-field Karl…. The licence is MIT.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 695cd6c. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Use Case Writer loads about 4.1k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 248 tokens; SKILL.md has 1,906 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from phucnt-bazone-vietnam/use-case-writer at commit 695cd6c, republished under its MIT licence (© phucnt-bazone-vietnam). 1,906 words, ~4,134 tokens.
.claude/skills/use-case-writer/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.by Phúc NT · BA Zone · Digital School
This skill helps IT BAs scope, analyze, and document Use Cases in English Markdown following the standard 13-field template (Karl Wiegers / IIBA style), with best practices from Alistair Cockburn's "Writing Effective Use Cases" and the IIBA BABOK Guide.
Developed by Phúc NT as part of the Digital School training program by BA Zone — Vietnam's Business Analyst & Product Owner community.
Trigger this skill whenever the user needs to:
.md). Use the 2-column table layout that mirrors the original template.Step 1: CLASSIFY INPUT → identify which mode the user is in
Step 2: SCOPE THE UC → apply 4 scoping rules + coffee-break test
Step 3: WRITE THE UC → fill the 13 fields ONE SECTION AT A TIME
Step 4: VALIDATE → run the 20-point checklist before handoverBefore writing anything, identify which mode the user is in:
| Mode | Signals | Action |
|---|---|---|
| Mode A: Write new from feature | User pastes a feature description, BRD, PRD, or says "write UC for feature X" | Go to Step 2 (scope) → Step 3 (write sequentially) |
| Mode B: Split large feature into UC list | User says "split into UC list", "how many UCs does this feature need", uploads a large PRD | Go deep on Step 2 (apply 3 identification techniques), output the UC List first, then ask the user which UC to write in detail |
| Mode C: Refine / review existing UC | User pastes an existing UC and asks "review this", "is it complete", "what's missing" | Skip Step 2, go directly to Step 4 (validate checklist) |
| Mode D: Write a specific section | User says "write the Normal Course for this UC", "add Exceptions" | Read the UC context, jump to the relevant part of Step 3 |
Golden rule: If input is vague (just one line), ASK before writing — never make things up. Ask at most 3 questions:
Communicate with the user in their language (Vietnamese or English), but the UC artifact is always English.
This is the most important and most error-prone part of UC writing. Read carefully.
Rule 1 - Coffee-break test (Alistair Cockburn) After completing the UC, can the actor take a coffee break without feeling the task is unfinished? If NO → the UC is too low-level (sub-function), merge it. If YES → scope is right (user-goal level).
Rule 2 - Goal Level (Cockburn's 3 levels)
Rule 3 - One Actor, One Goal, One Session Each UC should have EXACTLY: 1 primary actor + 1 business goal + completion in 1 continuous session. If you see 2 different goals → split into 2 UCs.
Rule 4 - System Boundary A UC describes the interaction between actor and system, NOT the system's internals. Each step must be one of:
When splitting a large feature into a UC list:
Technique 1: Goal-driven (top-down) List all goals for each actor → each goal = 1 candidate UC.
Technique 2: Event-driven (external + internal triggers)
Technique 3: CRUD-driven (data-centric) For each business entity (Learner, Course, Enrollment, Certificate…), check whether the system needs Create / Read / Update / Delete. Each = 1 candidate UC (you can merge R-U-D for the same entity if logic is similar).
Mode A: One sentence confirming scope, then ASK USER TO CONFIRM before moving to Step 3:
"Scope confirmed: this UC is at user-goal level. Primary actor: [X]. Goal: [Y]. System boundary: [Z]. Confirm to proceed to Step 3?"
Mode B: A UC List table:
| UC ID | UC Name (verb + noun) | Primary Actor | Goal | Priority |
| UC-01 | Enroll in Digital School course | Learner | ... | High |
| UC-02 | Book 1-on-1 mentor session | Learner | ... | High |
| UC-03 | Approve learner KYC application | BO Approver | ... | Medium |Then ask: "Which UC do you want me to write in detail first?"
CRITICAL: Generate ONE SECTION GROUP at a time, then STOP and ask the user to confirm before continuing. Do not dump the whole UC at once.
Read references/template-guide.md for detailed guidance on filling each field.
Read references/writing-style.md for writing conventions (active voice, numbering, anti-patterns).
| **Use Case ID:** | UC-XX-YY |
| **Use Case Name:** | [Action verb + noun] |
| **Created By:** | | **Last Updated By:** | |
| **Date Created:** | | **Date Last Updated:** | |
| **Actor:** | [Primary actor] / [Secondary actors] |
| **Description:** | [2-3 sentences: why + what + outcome] |
| **Preconditions:** | 1. ... 2. ... |
| **Postconditions:** | 1. ... 2. ... |
| **Priority:** | High / Medium / Low |
| **Frequency of Use:** | [X times / unit time] |
| **Normal Course of Events:** | 1. Actor... 2. System... 3. ... |
| **Alternative Courses:**| UC-XX-YY.AC.1: [name] |
| **Exceptions:** | UC-XX-YY.EX.1: [name] |
| **Includes:** | UC-AA-BB |
| **Special Requirements:**| [Non-functional: perf, security…] |
| **Assumptions:** | 1. ... |
| **Notes and Issues:** | TBD-1: [open question] / Owner / Due |Copy-ready template lives in assets/uc-template.md.
Generate in this exact order, pause and ask confirmation after each group:
Group 1 — Identification + Actor + Description Output: Use Case ID, Name, History (Created By / Date), Actor, Description. Then say: "Group 1 done. Confirm to proceed to preconditions, postconditions, priority, frequency?"
Group 2 — Conditions + Priority + Frequency Output: Preconditions, Postconditions, Priority, Frequency of Use. Then say: "Group 2 done. Confirm to proceed to the Normal Course?"
Group 3 — Normal Course of Events Output: numbered, step-by-step happy path. Then say: "Normal Course done. Confirm to proceed to Alternative Courses and Exceptions?"
Group 4 — Alternative Courses + Exceptions Output: AC.1, AC.2…, EX.1, EX.2… Then say: "Group 4 done. Confirm to proceed to the final group (Includes, Special Req, Assumptions, Notes)?"
Group 5 — Includes + Special Requirements + Assumptions + Notes and Issues Output: the remaining fields. Then say: "All sections done. Shall I run the 20-point quality validation now?"
If the user requests changes to a previous group, apply them and reconfirm before continuing.
If the user says "skip ahead" or "give me everything at once", honor that — but warn briefly that sequential mode catches more issues.
Use Case ID: Format UC-<module>-<seq>, e.g. UC-LEARN-01. Hierarchical X.Y if you have UC groups.
Use Case Name: MUST be "Verb + Object" (active voice).
Actor: Distinguish:
Preconditions: Conditions that MUST be true before the UC starts. Distinguish from business rules!
Postconditions: System state AFTER successful UC completion. Must be verifiable.
Normal Course of Events (most important):
Alternative Courses: Different paths that still lead to success. E.g. paying with enterprise voucher instead of personal wallet. Format UC-XX.AC.N + "At step Y of Normal Course, if [condition], execute the alternative: …"
Exceptions: Cases where the goal fails (errors, validation fails, timeouts). Format UC-XX.EX.N. Each exception needs: trigger condition + system response + final state.
Includes: List of sub-UCs "called" by this UC (common functionality). E.g. UC "Enroll in course" includes UC "Process payment".
Special Requirements: Non-functional requirements specific to this UC:
Assumptions: Things assumed during analysis. Different from Preconditions — a precondition is a hard requirement; an assumption is a belief that hasn't been verified.
Notes and Issues: List of TBDs with format [TBD-N] | Owner | Due date | Resolution.
ALWAYS run this checklist BEFORE handing over the UC. If any item fails, fix it or flag it to the user.
Read references/quality-checklist.md for the full checklist with examples. The 20 items, grouped:
Validation output: A Item | Status | Note table with ✅ ❌ ⚠️ markers.
.md file if the user wants a downloadable file; otherwise show inline in chat<UC-ID>_<UC-Name-kebab>.md, e.g. UC-LEARN-01_enroll-digital-school-course.mdreferences/template-guide.md - Detailed guidance for each field (with EdTech & Digital School examples)references/writing-style.md - Writing conventions (active voice, numbering, anti-patterns)references/quality-checklist.md - 20-point checklist with pass/fail examplesreferences/examples-edtech.md - 2 complete EdTech UC examples (Course Enrollment, Mentor Session Approval)assets/uc-template.md - Copy-ready Markdown templateSkill developed by Phúc NT · BA Zone · Digital School
Please keep attribution intact when sharing or forking this repo.
© phucnt-bazone-vietnam, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 9 other files (references, assets) in the repository root of phucnt-bazone-vietnam/use-case-writer.
Open the folder on GitHubat commit 695cd6c
Use Case Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Use Case Writer this skillphucnt-bazone-vietnam/use-case-writer | 143 | — | ~4.1k | Automated safety check: Pass | MIT | |
| Write Brddigoal/blog | 8.6k | — | ~1.4k | Automated safety check: Pass | GPL-2.0 | |
| Ralph Tui Create Beadssubsy/ralph-tui | 2.5k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Ralph Tui Create Beads Rustsubsy/ralph-tui | 2.5k | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| Ralph Tui Create JSONsubsy/ralph-tui | 2.5k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| B2B PRD GeneratorpmYangKun/create-prd-skill | 348 | — | ~879 | Automated safety check: Pass | None |
digoal/blog
Write a practical Business Requirements Document (BRD) from a product idea, feature concept, customer request, business problem, or rough product opportunity.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).
subsy/ralph-tui
Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.
pmYangKun/create-prd-skill
Writes a structured first draft of a B2B product requirements document from your business context, chapter by chapter, with Mermaid diagrams.
ywwynm/EverythingDone
Turn the current conversation context into a PRD and publish it to the project issue tracker.
Categories
Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA). Use Case Writer is an agent skill from phucnt-bazone-vietnam/use-case-writer. Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).
Use Case Writer fits situations like: A BA needs to scope; review a Use Case; include write a use case; use case specification.
Run `npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a claude-code`. Or copy the skill folder (the phucnt-bazone-vietnam/use-case-writer repository) into .claude/skills/use-case-writer in your project. Claude Code loads it when a task matches its description.
Run `npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a codex`. Or copy the skill folder (the phucnt-bazone-vietnam/use-case-writer repository) into .agents/skills/use-case-writer in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add phucnt-bazone-vietnam/use-case-writer --skill use-case-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-case-writer, .gemini/skills/use-case-writer, .github/skills/use-case-writer and .opencode/skills/use-case-writer in your project.
SKILL.md names no scripts, command-line tools or credentials: Use Case Writer is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Use Case Writer is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
About 4.1k tokens (SKILL.md is roughly 17k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 14k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Use Case Writer: Write Brd (digoal/blog, 8.6k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars) and Ralph Tui Create JSON (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
phucnt-bazone-vietnam (a GitHub user) maintains it in phucnt-bazone-vietnam/use-case-writer, which has 143 GitHub stars. The repository was last updated on May 16, 2026.
Source: phucnt-bazone-vietnam/use-case-writer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.