Ss Spec
Serial-Studio/Serial-Studio
Phase 1 of Serial Studio's spec-driven workflow: capture WHAT a feature must do and WHY, with no implementation detail.
A skill your agent uses to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable…
$ npx skills add magnus919/agent-skills --skill bmad -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install magnus919/agent-skills bmad --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bmad .claude/skills/bmad && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .claude/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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.
$skill-installer install https://github.com/magnus919/agent-skills/tree/main/bmadType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add magnus919/agent-skills --skill bmad -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install magnus919/agent-skills bmad --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/bmad .agents/skills/bmad && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .agents/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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 magnus919/agent-skills --skill bmad -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install magnus919/agent-skills bmad --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/bmad .cursor/skills/bmad && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .cursor/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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.
$ gemini skills install https://github.com/magnus919/agent-skills.git --path bmad--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add magnus919/agent-skills --skill bmad -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install magnus919/agent-skills bmad --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/bmad .gemini/skills/bmad && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .gemini/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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 magnus919/agent-skills bmadInstalls 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 magnus919/agent-skills --skill bmad -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/bmad .github/skills/bmad && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .github/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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 magnus919/agent-skills --skill bmad -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install magnus919/agent-skills bmad --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/bmad .opencode/skills/bmad && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bmad" agent skill from https://github.com/magnus919/agent-skills/tree/main/bmad into .opencode/skills/bmad/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bmad", 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.
bmadA skill your agent uses to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable…
Bmad is an agent skill from magnus919/agent-skills. Use this skill to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable agent work. Compress intent into a five-field contract (Why, Capabilities, Constraints, Non-goals, Success signal); classify work as direct/bounded/initiative and route to the smallest safe path; carry decisions in durable artifacts; review as triage; route failure to the layer where ambiguity entered; and gate autonomy on…
Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/adoption.md`).
It sits in Development, covering Spec-driven development. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 22b4723. 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.
Ships 2 files in scripts/ (Python, from the files we listed), which the agent can run.
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.
Bmad loads about 2.6k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 253 tokens; SKILL.md has 1,040 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); the scripts in this folder are not scanned.
The full file from magnus919/agent-skills at commit 22b4723, republished under its MIT licence (© magnus919). 1,040 words, ~2,604 tokens.
.claude/skills/bmad/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.BMad is a software-delivery method built on one idea: human intent should be progressively clarified, recorded, reviewed, and handed to agents as durable context rather than improvised in chat. This skill turns that method into a protocol any agent harness can follow — no official BMad installer required.
The loop: classify the request → compress intent into a contract → route to the smallest safe path → implement one bounded unit → review as triage → route failure to the layer where ambiguity entered → gate autonomy on observable acceptance → learn from completed work.
Load when a change request, feature, bug report, delegated build, or multi-agent epic needs:
| Class | Shape | Process |
|---|---|---|
| Direct | clear goal, local change, established patterns, small blast radius | implement immediately after minimal clarification |
| Bounded | coherent change needing a short contract and plan | intent contract → plan → implement → review |
| Initiative | cross-component, multi-story, high-risk, or strategically uncertain | analysis → planning → solutioning → implementation → learning |
Load references/classification.md for the decision table, the one-question rule, and stop conditions.
For bounded or initiative work, establish a contract before implementation:
If a field is materially ambiguous, ask one high-leverage question, propose a recommended answer, and wait for the decision. For trivial changes the contract can be five bullets in conversation; for larger work it becomes a versioned spec file.
Load references/spec.md for SPEC authoring and the status vocabulary. Templates: templates/SPEC.md and templates/INTENT.md.
Machine-readable status for resumable work:
| Status | Meaning |
|---|---|
draft | Spec exists but is not ready |
ready-for-dev | Passed readiness; ready to implement |
in-progress | Implementation underway |
in-review | Review or triage underway |
done | Workflow completed successfully |
blocked | Cannot safely continue unattended |
blocked is a routing signal, not failure: a higher-level orchestrator, another
workflow, or a human takes over. Validate a spec deterministically with
scripts/check-spec.py.
When something is wrong, diagnose the layer where the failure entered:
| Failure | Route |
|---|---|
| Wrong outcome or wrong problem | intent / analysis |
| Missing or contradictory requirement | contract / planning |
| Conflicting technical approach | architecture |
| Incorrect local code | implementation |
| Insufficient test or evaluation | verification |
| Unrelated pre-existing issue | defer explicitly |
| Unsafe ambiguity | block and ask |
Do not keep patching code when the specification is the real problem.
Autonomous execution is allowed only when all of these hold: intent contract coherent, acceptance observable, boundary explicit, repository safe to modify, tests or evaluations runnable, durable status writable, escalation defined. During autonomous work: one coherent change at a time; never expand scope on unrelated improvements; never merge, deploy, or change external systems without authorization; stop on intent gaps, missing capability, destructive ambiguity, failed verification, or non-convergent repair.
| Reference | Load when |
|---|---|
| references/protocol.md | You need the full paste-ready operating protocol for an agent |
| references/classification.md | Classifying a request or choosing ceremony depth |
| references/spec.md | Writing or resuming a SPEC / intent contract |
| references/lifecycle.md | Running an initiative through all four phases |
| references/project-context.md | Setting up or auditing repository rules (AGENTS.md) |
| references/review-and-failure-routing.md | Running a review or diagnosing a failure |
| references/autonomy.md | Configuring or running autonomous (Build Auto) work |
| references/party-mode.md | Deliberation, trade-offs, design debates, post-mortems |
| references/adoption.md | Adopting the protocol incrementally or mapping to a dark factory |
| Template | Purpose |
|---|---|
| templates/SPEC.md | Versioned machine contract for bounded/initiative work |
| templates/INTENT.md | Lightweight five-field contract for bounded work |
| templates/STORY.md | One bounded, dispatchable work unit |
| templates/REVIEW.md | Final human checkpoint: intent → behavior → risk → verification |
| Script | When to run |
|---|---|
| scripts/check-spec.py | After writing or editing a spec: validate five fields + status vocabulary (stdlib only, --json output) |
product-discovery validates whether a problem is real;
product-shaping sets an appetite and produces a pitch; product-strategy and
product-roadmapping-and-portfolio frame strategic context.spec-driven-development for formal spec/gate
pipelines; implementation-planning for a dependency-aware delivery plan;
adr-authoring for architecture decisions; software-architecture-analysis for
reverse-engineering an existing codebase.neckbeard for the issue-to-PR delivery flow;
verification-methodology for acceptance evidence; qa-methodology for test
strategy; agent-evals-and-observability for independent evaluators; agent-council
for Party-Mode-style multi-agent deliberation; release-engineering for deployment
gates; kanban-guru for backlog and dispatch policy.product-discovery. BMad compresses intent;
it does not establish whether the problem is real.product-shaping first (appetite,
pitch, bet). BMad starts from a placed intent.spec-driven-development owns SPEC format and gate mechanics; BMad provides the
control-plane protocol around them.neckbeard.
BMad complements it; do not run two competing delivery lifecycles.agent-council,
separate evaluators, or agent-evals-and-observability; never claim persona
separation as independent review.BMad is actively evolving (official repository: bmadcode/bmad-method; BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC). Older articles differ on name expansion, agents, file names, and commands. When installing the official tooling, treat the official docs and installed source as authoritative. This skill is an original distillation of the method as a harness-agnostic protocol; it does not reproduce official installer content.
© magnus919, 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 17 other files (scripts, references) in bmad of magnus919/agent-skills.
Open the folder on GitHubat commit 22b4723
Bmad 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 |
|---|---|---|---|---|---|---|
| Bmad this skillmagnus919/agent-skills | 115 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Ss SpecSerial-Studio/Serial-Studio | 7.2k | — | ~766 | Automated safety check: Pass | Custom licence | |
| PRP PlanWirasm/prp | 2.3k | — | ~4k | Automated safety check: Pass | MIT | |
| Spec Driven Workflowalirezarezvani/claude-skills | 28k | — | ~3.9k | Automated safety check: Pass | MIT | |
| CCPM Project Managementautomazeio/ccpm | 8.4k | — | ~1.1k | Automated safety check: Pass | MIT | |
| SPARC Development Methodologyruvnet/ruflo | 74k | 2 repos | ~829 | Automated safety check: Pass | MIT |
Serial-Studio/Serial-Studio
Phase 1 of Serial Studio's spec-driven workflow: capture WHAT a feature must do and WHY, with no implementation detail.
Wirasm/prp
Writes an implementation-ready plan for a feature, bug fix, refactor or chore from a PRD, issue or description, grounded in codebase evidence, and can post it back to the source issue.
alirezarezvani/claude-skills
A skill your agent uses when the user asks to write specs before code, define acceptance criteria, plan features before implementation, generate tests from specifications, or follow spec-first…
automazeio/ccpm
Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.
ruvnet/ruflo
Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.
dataelement/bisheng
Reviews BiSheng spec, design and tasks documents with checklists for PRD gaps, handover readiness and acceptance traceability, producing a report or an LGTM.
magnus919/agent-skills
Organize durable agent research outputs as summaries, analysis, and evidence dossiers.
magnus919/agent-skills
Build portable, first-person colored ASCII city engines and small GIS-derived city packs.
magnus919/agent-skills
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.
magnus919/agent-skills
A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…
magnus919/agent-skills
Use Docker Compose to define, run, debug, and harden multi-container applications.
magnus919/agent-skills
Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.
A skill your agent uses to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable…. Bmad is an agent skill from magnus919/agent-skills. Use this skill to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable agent work.
Bmad fits situations like: resumable agent work; A change request; delegated build; multi-agent epic needs intent capture.
Run `npx skills add magnus919/agent-skills --skill bmad -a claude-code`. Or copy the skill folder (bmad in magnus919/agent-skills) into .claude/skills/bmad in your project. Claude Code loads it when a task matches its description.
Run `npx skills add magnus919/agent-skills --skill bmad -a codex`. Or copy the skill folder (bmad in magnus919/agent-skills) into .agents/skills/bmad 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 magnus919/agent-skills --skill bmad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad, .gemini/skills/bmad, .github/skills/bmad and .opencode/skills/bmad in your project.
Going by SKILL.md and its folder, Bmad needs Python for the scripts in its folder. Our summary lists: Python 3.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Bmad is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.6k tokens (SKILL.md is roughly 10k 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 9.4k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Bmad: Ss Spec (Serial-Studio/Serial-Studio, 7.2k stars), PRP Plan (Wirasm/prp, 2.3k stars), Spec Driven Workflow (alirezarezvani/claude-skills, 28k stars) and CCPM Project Management (automazeio/ccpm, 8.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 115 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 10, 2026.
Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.