bmad-spec

bmad-spec is a skill for Claude Code from alvin-reyes/better-agentic-ide. It costs 76 tokens per session (3,793 once invoked), scanned A, original, MIT.

A specification-writing assistant that turns ideas, notes, requirements documents, conversations, or mixed material into a short, structured product specification. A specification records what to build, why, limits, exclusions, and how success will be judged.

In plain words
What is it for?
It helps create, update, and validate specifications and supporting files for downstream development tasks.
Why use it?
It removes ambiguity and gives later development work a shared source of requirements instead of relying on scattered notes.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

Good fit It helps create, update, and validate specifications and supporting files for downstream development tasks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/alvin-reyes/better-agentic-ide/bmad-spec
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add alvin-reyes/better-agentic-ide --skill bmad-spec
Clone the repo
git clone --depth 1 https://github.com/alvin-reyes/better-agentic-ide

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bmad-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/alvin-reyes/better-agentic-ide/bmad-spec/github.svg)](https://agentmods.dev/skills/alvin-reyes/better-agentic-ide/bmad-spec)
Your own site
<a href="https://agentmods.dev/skills/alvin-reyes/better-agentic-ide/bmad-spec"><img src="https://agentmods.dev/badge/skills/alvin-reyes/better-agentic-ide/bmad-spec/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for bmad-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/alvin-reyes/better-agentic-ide/bmad-spec"><img src="https://agentmods.dev/badge/skills/alvin-reyes/better-agentic-ide/bmad-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 76 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,793 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00076 $0.03793
Opus 5.5 $0.00030 $0.01517
Sonnet 5.5 $0.00015 $0.00759
Haiku 4.5 $0.00008 $0.00379

Measured today against content hash 5f3dc3553781, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bmad-spec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/bmad-spec/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

BMad Spec

Overview

Canonical transformer for the BMad spec-kernel ecosystem. Takes any intent input — vague idea, brain dump, PRD, GDD, RFC, brief, Slack thread, customer email, meeting transcript, mockups, mixed multi-source — and produces spec-{slug}.md carrying the five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) plus companion files for load-bearing content that does not fit or would bloat the kernel with expansive line-item detail. Together they are the machine contract every downstream BMad skill consumes.

Multiple skills may call to update the same spec over time.

Conventions

  • Bare paths (e.g. assets/spec-template.md) resolve from the skill root.
  • {skill-root} is this skill's install dir; {project-root} is the nearest folder containing _bmad/, starting at the working dir and moving up through its parents.
  • {workflow.<name>} resolves to fields in customize.toml.

On Activation

  1. Resolve customization: node {project-root}/_bmad/ade-runtime.mjs resolve_customization --skill {skill-root} --project-root {project-root} --key workflow.
    • Script not found: BMad is not set up here. Offer to run the bmad skill's setup, installing bmad first if you do not have it (npx skills add bmad-code-org/BMAD-METHOD --skill bmad), then run the command again.
    • Any other failure: read {skill-root}/customize.toml directly.
  2. Run {workflow.activation_steps_prepend}. Treat {workflow.persistent_facts} as foundational context (file: entries are loaded).
  3. Resolve config: node {project-root}/_bmad/ade-runtime.mjs resolve_config --project-root {project-root} --key core.output_folder --key core.active_initiative. {date} is the current system datetime.
    • Script not found, or no output_folder: BMad is not set up here. Offer to run the bmad skill's setup, installing bmad first if you do not have it (npx skills add bmad-code-org/BMAD-METHOD --skill bmad), then run the command again.
    • No active_initiative: hand off to the bmad skill to set or create one, then run the command again and continue. Headless: write loose.
  4. Detect mode. Headless when any of: no TTY, programmatic caller (another skill or non-interactive runner), or the first message pre-supplies all inputs and asks for an artifact path back. Interactive otherwise. In interactive mode, greet the user and mention that bmad-party-mode and bmad-advanced-elicitation are available for deeper exploration on any field.

Read the full file on GitHub · 158 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 158 lines · 76 tokens per session scan A 5f3dc3553781

Subscribe to this mod's changes

bmad-spec is a skill published in the GitHub repository alvin-reyes/better-agentic-ide (85 stars, last pushed 9d ago), licensed MIT. It adds 76 tokens to every session and 3,793 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-26.

Related

Other skills, from other repositories

vigilante-create-issue

Help a human author write an implementation-ready GitHub issue that Vigilante can execute reliably.

aliengiraffe/vigilante · 25 tokens

rn-device-control

This skill should be used when the user asks to "control the simulator", "take a screenshot", "boot the emulator", "install the app", "read UI hierarchy", "manage device state", "open a deep link", "grant permissions", "stream native logs", "disable animations", "change device locale", or needs guidance on xcrun…

Lykhoyda/rn-dev-agent · 98 tokens

rn-feature-development

This skill should be used when building any new feature in a React Native or Expo app, or when the $rn-dev-agent:rn-feature-dev command runs. Triggers on "build a feature", "add X to the app", "implement Y", "create a new screen", "rn-feature-dev", "feature development", "build me X", "add a screen", "wire up this…

Lykhoyda/rn-dev-agent · 86 tokens

rn-testing

This skill should be used when the user asks to "write a Maestro test", "create E2E flows", "add testIDs", "run UI tests", "run E2E tests", "verify a feature works", "test my screen", "set up maestro-runner", "mock network requests", "inspect store state", "write test assertions", or needs guidance on test timing…

Lykhoyda/rn-dev-agent · 106 tokens

rn-workflow

Validate and establish the proven rn-dev-agent operating sequence before a real React Native journey — read project instructions and the declared package manager, inventory sessions/Metro/devices read-only, establish one exclusive simulator/emulator via typed session actions, apply and verify package integration and…

Lykhoyda/rn-dev-agent · 91 tokens

using-rn-dev-agent

Entry point for the rn-dev-agent plugin. Maps user intent to the right command, agent, or skill. Use at the START of any React Native development conversation. Triggers on "I want to build", "build a feature", "add a feature to the app", "test this", "something is broken", "fix the crash", "help with my React Native…

Lykhoyda/rn-dev-agent · 92 tokens