Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO.

MITAuto-check passedProduct & Project Management

Install User Story Ac Writer

skills CLI
$ npx skills add phucnt-bazone-vietnam/ba-zone-user-story-ac-writer --skill user-story-ac-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install phucnt-bazone-vietnam/ba-zone-user-story-ac-writer user-story-ac-writer --agent claude-code

Project 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/

Facts

Skill name
user-story-ac-writer
GitHub stars
180
Token cost
~1.5k tokens
SKILL.md length
725 words
Files
9 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Sinh User Story và Acceptance Criteria chuẩn INVEST + Given-When-Then cho BA/PO.

  • Works in 4 steps: Persona/User type: Ai sẽ dùng tính năng?… → Goal: User muốn làm gì? → Business value: Tại sao cần tính năng này? → …
  • Tasks that involve User stories
  • SKILL.md covers Mục đích, Workflow chuẩn, Anti-patterns - KHÔNG làm… and Khi nào cần split User Story?, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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.

When your agent uses it

  • Tasks that involve User stories

Example prompts

  • “viết user story”
  • “viết US”
  • “tạo user story”
  • “/user-story-ac-writer”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Persona/User type: Ai sẽ dùng tính năng? (Học viên, Mentor, Admin, Doanh nghiệp...)
  2. Goal: User muốn làm gì?
  3. Business value: Tại sao cần tính năng này?
  4. Context/Scope: Tính năng nằm trong feature/module nào?

What it can do on your machine

Read from SKILL.md and the folder at commit 53c9db0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    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.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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.

Always · name and description, kept in context so the agent knows when to use it
~253
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.4k

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.

Safety

Auto-check passed

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.

SKILL.md

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.

Download SKILL.mdSave it as .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.
name
user-story-ac-writer
description
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 story", "review US này", "US này đã chuẩn chưa", "bổ sung AC", "viết tiêu chí nghiệm thu", "story cho feature này", "split user story", "story quá to cần tách", kể cả khi paste feature description + nói "viết story đi" hoặc upload PRD + "tạo US list". KHÔNG dùng cho: viết PRD/URD/SRS toàn bộ (dùng prd-writer, srs-writer), viết test case kỹ thuật chi tiết (AC ≠ test case), viết Use Case formal (dùng po-usecase-refiner), business rules (dùng business-rule-generator).
author
Phúc NT @ BA Zone
source
https://github.com/ba-zone

User Story & Acceptance Criteria Writer

by Phúc NT — BA Zone & Digital School

Mục đích

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.

Workflow chuẩn

Bước 1: Xác định mode

Hỏi user 1 trong 3 mode:

  • Mode A - Viết mới: User cung cấp feature description, skill sinh US + AC từ đầu
  • Mode B - Refine: User có US/AC sẵn, skill review và đề xuất sửa
  • Mode C - Bổ sung AC: User có US, cần thêm AC chi tiết

Nếu user paste content rõ ràng, tự suy luận mode và xác nhận lại 1 lần.

Bước 2: Thu thập input bắt buộc

Cần đủ 4 thông tin trước khi sinh, hỏi nếu thiếu:

  1. Persona/User type: Ai sẽ dùng tính năng? (Học viên, Mentor, Admin, Doanh nghiệp...)
  2. Goal: User muốn làm gì?
  3. Business value: Tại sao cần tính năng này?
  4. Context/Scope: Tính năng nằm trong feature/module nào?

KHÔNG được tự bịa nếu user không cung cấp - phải hỏi.

Bước 3: Sinh User Story theo template

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]
Bước 4: Apply checklist INVEST

Trước khi xuất, tự kiểm tra US theo 6 tiêu chí:

Tiêu chíCâu hỏi kiểm traNếu fail thì làm gì
IndependentStory có phụ thuộc story khác không?Tách dependency hoặc gộp
NegotiableCó để chỗ cho thảo luận không?Bỏ chi tiết kỹ thuật cứng
ValuableMang lại giá trị gì cho user/business?Viết lại phần "So that"
EstimableDev có ước lượng được effort không?Bổ sung context/constraint
SmallHoàn thành trong 1 sprint không?Split thành nhiều story
TestableQA viết được test case không?Bổ sung AC cụ thể

Tham khảo chi tiết: references/invest-criteria.md

Bước 5: Sinh Acceptance Criteria

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:

  • Bao quát đủ 3 loại: happy path, edge case, negative path
  • Mỗi điều kiện trong Given/When/Then phải đo lường được (số liệu, trạng thái rõ ràng)
  • Tránh từ mơ hồ: "nhanh", "hợp lý", "user-friendly"
  • Không viết logic implementation (đó là việc của dev)
  • 1 AC = 1 scenario duy nhất, không gộp nhiều case
Bước 6: Output cuối cùng

Trình bày theo format:

  1. User Story (3 dòng As a / I want / So that)
  2. INVEST Self-check (bảng đánh giá 6 tiêu chí với ✅/⚠️)
  3. Acceptance Criteria (đánh số AC1, AC2, AC3...)
  4. Notes (nếu có dependency, assumption, hoặc câu hỏi cần PO làm rõ)
  5. Yêu cầu xem lại toàn bộ tài liệu trước khi xuất tài liệu. Hỏi định dạng tài liệu để user xác nhận trước khi xuất.
Show full SKILL.md (260 more words)Show less

Anti-patterns - KHÔNG làm những điều sau

❌ 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

Khi nào cần split User Story?

Đề xuất split khi gặp các dấu hiệu:

  • Story chứa từ "AND" trong tiêu đề ("Login AND register")
  • Có nhiều persona khác nhau trong 1 story
  • Story cover nhiều CRUD operation
  • AC vượt quá 7-8 scenarios
  • Dev ước lượng > 5 ngày làm việc

Pattern split phổ biến:

  • Theo CRUD: tách Create / Read / Update / Delete
  • Theo persona: tách Học viên / Mentor / Admin / Doanh nghiệp
  • Theo business rule: tách Happy path / Validation / Permission
  • Theo data type: tách theo loại data xử lý

Tham khảo thêm

  • templates/user-story-template.md - template trống điền vào
  • templates/ac-template.md - template AC chuẩn Gherkin
  • references/invest-criteria.md - giải thích sâu INVEST
  • references/examples.md - 7 ví dụ mẫu cho EdTech & Digital School
  • checklists/quality-checklist.md - checklist self-review trước khi xuất

Skill đượ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

Files

SKILL.md and 8 other files (references) in the repository root of phucnt-bazone-vietnam/ba-zone-user-story-ac-writer.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • checklists/quality-checklist.md
  • references/examples.md
  • references/invest-criteria.md
  • templates/ac-template.md
  • templates/user-story-template.md

Open the folder on GitHubat commit 53c9db0

Compare with similar skills

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.

User Story Ac Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
User Story Ac Writer this skillphucnt-bazone-vietnam/ba-zone-user-story-ac-writer180—~1.5kAutomated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
To Specbestofjs/bestofjs3.1k21 repos~757Automated safety check: PassMIT

Similar skills

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

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Agile Product Owner

    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.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • To Spec

    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.

    3.1k GitHub starsUsed in 21 repos~757 tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

Questions about User Story Ac Writer

What does User Story Ac Writer do?

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.

When should I use User Story Ac Writer?

User Story Ac Writer fits situations like: tasks that involve User stories.

How do I install User Story Ac Writer in Claude Code?

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.

How do I install User Story Ac Writer in Codex?

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.

Can I use User Story Ac Writer in Cursor, Gemini CLI or GitHub Copilot?

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.

What does User Story Ac Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: User Story Ac Writer is instructions for the agent only.

Does User Story Ac Writer access the network?

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.

Is User Story Ac Writer safe to install?

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.

What licence does User Story Ac Writer use?

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.

How many tokens does User Story Ac Writer use?

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.

What are the alternatives to User Story Ac Writer?

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.

Who maintains User Story Ac Writer?

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.