User Story Writer
deanpeters/Product-Manager-Skills
Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.
Agent skill
by phucnt-bazone-vietnam in phucnt-bazone-vietnam/ba-zone-user-story-ac-writer
Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO.
$ npx skills add phucnt-bazone-vietnam/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install phucnt-bazone-vietnam/ba-zone-user-story-ac-writer user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .claude/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install phucnt-bazone-vietnam/ba-zone-user-story-ac-writer user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .agents/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install phucnt-bazone-vietnam/ba-zone-user-story-ac-writer user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .cursor/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install phucnt-bazone-vietnam/ba-zone-user-story-ac-writer user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .gemini/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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/ba-zone-user-story-ac-writer user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .github/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-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/ba-zone-user-story-ac-writer user-story-ac-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 "user-story-ac-writer" agent skill from https://github.com/phucnt-bazone-vietnam/ba-zone-user-story-ac-writer/tree/main into .opencode/skills/user-story-ac-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "user-story-ac-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.
user-story-ac-writerSinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO.
User Story Ac Writer is an agent skill from phucnt-bazone-vietnam/ba-zone-user-story-ac-writer. Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO. Skill enforce 6 tiêu chí INVEST (Independent, Negotiable, Valuable, Estimable, Small, Testable) và format AC theo Gherkin syntax. Hỗ trợ 3 mode: viết mới từ feature description, refine US đang có, bổ sung AC cho US đã viết. Dùng khi user nói: "viết user story", "viết US", "tạo user story", "viết AC", "viết acceptance criteria", "tạo AC cho story", "user story chuẩn INVEST", "AC theo Given-When-Then", "AC Gherkin", "refine user…
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `README.md`, `checklists/quality-checklist.md` and `references/examples.md`).
It sits in Product & Project Management, covering User stories. The repository describes itself as: Skill Claude AI giúp BA/PO viết User Story & AC chuẩn INVEST + Given-When-Then · by Phúc NT · BA Zone. The licence is MIT.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 53c9db0. 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.
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.
User Story Ac Writer loads about 1.5k tokens when it runs, and up to ~7.4k if it reads all its reference files. Until then it costs about 253 tokens; SKILL.md has 725 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/ba-zone-user-story-ac-writer at commit 53c9db0, republished under its MIT licence (© phucnt-bazone-vietnam). 725 words, ~1,537 tokens.
.claude/skills/user-story-ac-writer/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.by Phúc NT — BA Zone & Digital School
Skill này giúp BA/PO viết User Story và Acceptance Criteria đạt chuẩn chất lượng cao, sẵn sàng cho dev estimate và QA viết test case.
Được phát triển bởi Phúc NT trong khuôn khổ chương trình đào tạo Digital School của BA Zone — cộng đồng BA/PO Việt Nam.
Hỏi user 1 trong 3 mode:
Nếu user paste content rõ ràng, tự suy luận mode và xác nhận lại 1 lần.
Cần đủ 4 thông tin trước khi sinh, hỏi nếu thiếu:
KHÔNG được tự bịa nếu user không cung cấp - phải hỏi.
Dùng format chuẩn 3 thành phần:
**US-[ID]**: [Tiêu đề ngắn gọn]
**As a** [persona cụ thể, không generic như "user"]
**I want to** [hành động cụ thể, đo lường được]
**So that** [business value rõ ràng, không lặp lại I want]Trước khi xuất, tự kiểm tra US theo 6 tiêu chí:
| Tiêu chí | Câu hỏi kiểm tra | Nếu fail thì làm gì |
|---|---|---|
| Independent | Story có phụ thuộc story khác không? | Tách dependency hoặc gộp |
| Negotiable | Có để chỗ cho thảo luận không? | Bỏ chi tiết kỹ thuật cứng |
| Valuable | Mang lại giá trị gì cho user/business? | Viết lại phần "So that" |
| Estimable | Dev có ước lượng được effort không? | Bổ sung context/constraint |
| Small | Hoàn thành trong 1 sprint không? | Split thành nhiều story |
| Testable | QA viết được test case không? | Bổ sung AC cụ thể |
Tham khảo chi tiết: references/invest-criteria.md
Mỗi US cần tối thiểu 3 AC, format Given-When-Then:
**AC1: [Tên scenario - happy path]**
- **Given** [tiền điều kiện cụ thể]
- **When** [hành động user thực hiện]
- **Then** [kết quả mong đợi đo lường được]
- **And** [kết quả phụ nếu có]
**AC2: [Tên scenario - edge case/validation]**
...
**AC3: [Tên scenario - error/negative path]**
...Quy tắc viết AC tốt:
Trình bày theo format:
❌ Persona generic: "As a user" → ✅ "As a học viên Digital School đã đăng ký khóa học và xác thực email"
❌ Goal vague: "I want to manage profile" → ✅ "I want to update my email address"
❌ Value lặp lại goal: "So that I can manage profile" → ✅ "So that I receive notifications at correct address"
❌ AC mô tả UI: "Then button turns blue" → ✅ "Then system displays confirmation message"
❌ AC chứa logic kỹ thuật: "Then call API /v1/users/update" → ✅ "Then user data is updated and persisted"
❌ AC quá ít: chỉ có 1 happy path → ✅ tối thiểu 3 AC bao quát các nhánh
❌ Story quá lớn: 1 story cover cả CRUD → ✅ tách thành Create, Read, Update, Delete riêng
Đề xuất split khi gặp các dấu hiệu:
Pattern split phổ biến:
templates/user-story-template.md - template trống điền vàotemplates/ac-template.md - template AC chuẩn Gherkinreferences/invest-criteria.md - giải thích sâu INVESTreferences/examples.md - 7 ví dụ mẫu cho EdTech & Digital Schoolchecklists/quality-checklist.md - checklist self-review trước khi xuấtSkill được phát triển bởi Phúc NT · BA Zone · Digital School
Vui lòng giữ nguyên attribution khi chia sẻ hoặc fork repo này.
© 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 8 other files (references) in the repository root of phucnt-bazone-vietnam/ba-zone-user-story-ac-writer.
Open the folder on GitHubat commit 53c9db0
User Story Ac 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 |
|---|---|---|---|---|---|---|
| User Story Ac Writer this skillphucnt-bazone-vietnam/ba-zone-user-story-ac-writer | 180 | — | ~1.5k | Automated safety check: Pass | MIT | |
| User Story Writerdeanpeters/Product-Manager-Skills | 7.2k | 2 repos | ~2.9k | Automated safety check: Pass | Custom licence | |
| Ralph Tui Create Beadssubsy/ralph-tui | 2.5k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Agile Product Owneralirezarezvani/claude-skills | 28k | 3 repos | ~3.2k | Automated safety check: Pass | MIT | |
| Ralph Tui Create Beads Rustsubsy/ralph-tui | 2.5k | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| To Specbestofjs/bestofjs | 3.1k | 21 repos | ~757 | Automated safety check: Pass | MIT |
deanpeters/Product-Manager-Skills
Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.
alirezarezvani/claude-skills
Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).
bestofjs/bestofjs
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
subsy/ralph-tui
Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.
Categories
Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO. User Story Ac Writer is an agent skill from phucnt-bazone-vietnam/ba-zone-user-story-ac-writer. Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO.
User Story Ac Writer fits situations like: tasks that involve User stories.
Run `npx skills add phucnt-bazone-vietnam/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a claude-code`. Or copy the skill folder (the phucnt-bazone-vietnam/ba-zone-user-story-ac-writer repository) into .claude/skills/user-story-ac-writer in your project. Claude Code loads it when a task matches its description.
Run `npx skills add phucnt-bazone-vietnam/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a codex`. Or copy the skill folder (the phucnt-bazone-vietnam/ba-zone-user-story-ac-writer repository) into .agents/skills/user-story-ac-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/ba-zone-user-story-ac-writer --skill user-story-ac-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/user-story-ac-writer, .gemini/skills/user-story-ac-writer, .github/skills/user-story-ac-writer and .opencode/skills/user-story-ac-writer in your project.
SKILL.md names no scripts, command-line tools or credentials: User Story Ac 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.
User Story Ac 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 1.5k tokens (SKILL.md is roughly 6.1k 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 5.8k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with User Story Ac Writer: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Agile Product Owner (alirezarezvani/claude-skills, 28k stars) and Ralph Tui Create Beads Rust (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/ba-zone-user-story-ac-writer, which has 180 GitHub stars. The repository was last updated on May 19, 2026.
Source: phucnt-bazone-vietnam/ba-zone-user-story-ac-writer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.