BA Skills for Claude ★ GitHub
Open source · MIT · EN & Tiếng Việt

Business Analyst Skills for Claude

Claude skills that work like a senior Business Analyst: requirements, user stories, functional decomposition, BPMN, decision tables and API specs, plus the domain questions a senior BA would ask.

★ Get it on GitHubQuick startWatch the demo
10+method skills
5+domain packs
EN · VIlanguages
claude
# install the plugin
› /plugin marketplace add lechithinh/ba-claude-skills
› /plugin install ba-claude-skills@ba-claude-skills
# then just ask
› Write user stories for interbank transfer in our mobile banking app.

Why domain knowledge matters

AI already knows how to write a requirement. A senior BA knows what to ask in a specific domain.

AI without context

2 scenarios
  • Successful transfer
  • Insufficient balance

With the banking domain pack

7 scenarios + questions
  • Beneficiary name inquiry before confirming
  • Per-transaction and daily limits
  • Biometric authentication above a threshold
  • Timeout, pending, reconciliation, auto-refund
  • Duplicate-submission protection
  • Fee not covered by the balance
  • 5 open questions for Compliance and Operations

See the full before and after examples →

Watch a process run

A diagram can look perfect and still hide a bug. bpmn-modeling runs tokens through scenarios and shows exactly where the process gets stuck.

Animated BPMN diagram, AS-IS: the token gets stuck on Receive payment result when the payment gateway never replies

Swipe sideways to see the whole diagram

AS-IS: it looks fine. When the payment gateway never replies, the token waits forever: a hanging order and a customer who may already be charged.
Animated BPMN diagram, TO-BE: a 5-minute timer sends the token to Order awaiting reconciliation

Swipe sideways to see the whole diagram

TO-BE: the fix. A 5-minute timer sends the token down the exception path to an Operations step instead of waiting forever.

Try AS-IS (interactive)Try TO-BE (interactive)

Method skills

How a BA works: ten skills that follow BABOK techniques and chain into each other.

01

Meeting to Requirements

Transcripts become goals, functional and non-functional requirements, business rules and open questions, each traced to a quote.

Guide and source
02

Requirements Linter

Scores each requirement 0 to 10, flags vague, untestable and compound statements and missing domain scenarios, then rewrites them.

Guide and source
03

Functional Decomposition

System, modules, features, functions with stable IDs, lint, CRUD gap check and an interactive explorer.

Guide and source
04

User Story Writer

INVEST user stories with Gherkin acceptance criteria, error paths and Jira CSV export.

Guide and source
05

BPMN Modeling

BPMN 2.0 from a description: Mermaid, .bpmn, SVG and a token run that finds stuck scenarios.

Source on GitHub
06

BA Diagrams

Use case, sequence, ERD, state and context diagrams in valid Mermaid.

Guide and source
07

Screen Spec

Screen specification from a mockup image: field table, validations, states and open questions.

Source on GitHub
08

Decision Table

Business rules to a decision table; a script finds missing, conflicting and overlapping rules.

Source on GitHub
09

Edge-case Finder

A short, prioritised list of what-if cases with questions per stakeholder and Gherkin AC.

Source on GitHub
10

API Spec

Draft API contract from requirements, business error codes and OpenAPI 3.0 YAML.

Source on GitHub

Domain packs

What a BA must know: glossary, processes, business rules, a question checklist, data model, integrations, regulations and KPIs.

01

Banking

eKYC, accounts, transfers (NAPAS, CITAD), cards, lending, deposits, disputes.

Guide and source
02

E-commerce

Catalog, vouchers, checkout, orders, shipping and COD, returns, marketplace settlement.

Guide and source
03

Payments and e-wallet

Top-up, withdrawal, QR, refund and chargeback, settlement, three-way reconciliation.

Source on GitHub
04

Lending and BNPL

Origination, decisioning, flat vs reducing interest, repayment allocation, collections by DPD.

Source on GitHub
05

Logistics

Last mile, failed delivery, COD remittance, volumetric weight, warehouse basics.

Source on GitHub

Quick start

Then describe your task and business context, for example: "Write user stories for interbank transfer in our mobile banking app."

Claude Code

/plugin marketplace add lechithinh/ba-claude-skills
/plugin install ba-claude-skills@ba-claude-skills

Manual (Claude Code)

git clone https://github.com/lechithinh/ba-claude-skills.git && cp -r ba-claude-skills/skills/* ~/.claude/skills/

Claude.ai

Download skill zips from Releases and upload them in Settings, Capabilities, Skills. Upload a method skill and the domain pack you need.

Cursor, Codex, Gemini CLI

Point the agent to AGENTS.md.

Learn the BA techniques

Each skill comes with a short guide to the technique behind it: BABOK references, common mistakes and practice exercises.

Requirements quality checklist

The most common defects and how to rewrite them.

Functional decomposition

MECE, CRUD checks and when to stop decomposing.

From meeting notes to requirements

Sorting what stakeholders say into goals, rules and questions.

User stories and Gherkin

INVEST, acceptance criteria and splitting patterns.

Choosing the right BA diagram

Which diagram answers which stakeholder question.

Banking BA checklist

The questions a senior banking BA always asks.

E-commerce BA checklist

The questions a senior e-commerce BA always asks.

Clinic booking case study

From a meeting transcript to user stories and diagrams.

FAQ

Is it free?

Yes. It is MIT-licensed and open source.

Does it invent business rules?

No. Unknown values are left as [to confirm] placeholders, together with a list of open questions.

Does it work in Vietnamese?

Yes. Skills reply in your language, and the domain packs include English-Vietnamese glossaries.

Can I add my domain?

Yes. See the contributing guide.