Skip to content
cccskills
FreePublished on GitHub

bmad-toolsmith

Smithy the Toolsmith builds, converts, reviews, packages, validates and migrates BMad skills, agents and modules. Use when the user wants a skill, agent, persona, command or module made, changed, reviewed or packaged; a prompt or rule from another tool turned into a skill; a skill mined from session logs; an old module migrated; or asks for Smithy. Not for running evals (`bmad-eval`), overriding an installed skill (`bmad-customize`), app code (`bmad-build`) or questions about BMad (`bmad`).

The English summary is being prepared. Showing the original description.

See how to install

Files included (88)

  • SKILL.md3.7 KB
  • approaches/eval-first.md1.4 KB
  • approaches/eval-loop.md2.7 KB
  • approaches/from-logs.md1.8 KB
  • approaches/lean.md2.0 KB
  • approaches/scaffold.md1.4 KB
  • approaches/skill-creator-loop.md1.4 KB
  • bmod.toml118 B
  • canon.md8.6 KB
  • customize.toml4.6 KB
  • discover.md7.0 KB
  • ecosystem.md1.7 KB
  • evals/triggers.json2.6 KB
  • lenses/lens-architecture.md2.9 KB
  • lenses/lens-contract.md1.3 KB
  • lenses/lens-customization.md2.2 KB
  • lenses/lens-determinism.md1.8 KB
  • lenses/lens-leanness.md2.4 KB
  • lenses/lens-trigger.md2.1 KB
  • lenses/standards.md5.2 KB
  • modes/convert.md2.4 KB
  • modes/edit.md1.4 KB
  • modes/migrate.md3.8 KB
  • modes/package.md2.7 KB
  • modes/review.md1.6 KB
  • modes/validate.md2.0 KB
  • scripts/count_tokens.py3.6 KB
  • scripts/init_skill.py13.3 KB
  • scripts/prepass.py5.8 KB
  • scripts/process_template.py4.8 KB
  • scripts/read_session_log.py9.8 KB
  • scripts/registry.py5.9 KB
  • scripts/scan_legacy_module.py7.7 KB
  • scripts/scan_paths.py7.8 KB
  • scripts/scan_scripts.py6.6 KB
  • scripts/tests/test_count_tokens.py4.1 KB
  • scripts/tests/test_init_skill.py9.7 KB
  • scripts/tests/test_memory_agent_scripts.py7.1 KB
  • scripts/tests/test_prepass.py6.4 KB
  • scripts/tests/test_process_template.py4.7 KB
  • scripts/tests/test_read_session_log.py7.3 KB
  • scripts/tests/test_registry.py6.0 KB
  • scripts/tests/test_scan_legacy_module.py8.2 KB
  • scripts/tests/test_scan_paths.py6.6 KB
  • scripts/tests/test_scan_scripts.py4.1 KB
  • shapes/agent/assets/capability-template.md582 B
  • shapes/agent/assets/customize-template.toml1.9 KB
  • shapes/agent/assets/sample-capability.md887 B
  • shapes/agent/assets/SKILL-template.md2.1 KB
  • shapes/agent/shape.md3.4 KB
  • shapes/memory-agent/assets/BOND-template.md392 B
  • shapes/memory-agent/assets/CAPABILITIES-template.md1017 B
  • shapes/memory-agent/assets/CREED-template.md2.1 KB
  • shapes/memory-agent/assets/customize-template.toml1.2 KB
  • shapes/memory-agent/assets/first-breath-config-template.md4.0 KB
  • shapes/memory-agent/assets/first-breath-template.md8.8 KB
  • shapes/memory-agent/assets/HOW-I-REMEMBER-template.md3.3 KB
  • shapes/memory-agent/assets/init-sanctum-template.py5.7 KB
  • shapes/memory-agent/assets/intake-capability-template.md975 B
  • shapes/memory-agent/assets/PERSONA-template.md705 B
  • shapes/memory-agent/assets/PULSE-template.md849 B
  • shapes/memory-agent/assets/SKILL-template-bootloader.md4.3 KB
  • shapes/memory-agent/assets/wake-template.py5.6 KB
  • shapes/memory-agent/shape.md5.0 KB
  • shapes/multi-skill-module/assets/help-template.md623 B
  • shapes/multi-skill-module/assets/member-bmod-template.toml490 B
  • shapes/multi-skill-module/assets/record-bmod-template.toml802 B
  • shapes/multi-skill-module/assets/record-SKILL-template.md374 B
  • shapes/multi-skill-module/assets/retired-template.toml287 B
  • shapes/multi-skill-module/assets/roster-template.toml567 B
  • shapes/multi-skill-module/shape.md4.1 KB
  • shapes/plain-skill/assets/customize-template.toml1.0 KB
  • shapes/plain-skill/assets/sample-skill/SKILL.md1.7 KB
  • shapes/plain-skill/assets/SKILL-template.md2.0 KB
  • shapes/plain-skill/shape.md3.0 KB
  • shapes/rendered-skill/assets/customize-template.toml990 B
  • shapes/rendered-skill/assets/SKILL-template.md1.0 KB
  • shapes/rendered-skill/assets/step.md688 B
  • shapes/rendered-skill/assets/workflow.md1.2 KB
  • shapes/rendered-skill/shape.md2.2 KB
  • shapes/script-utility/assets/script-template.py1.5 KB
  • shapes/script-utility/assets/SKILL-template.md859 B
  • shapes/script-utility/assets/test-template.py1.2 KB
  • shapes/script-utility/shape.md2.0 KB
  • shapes/single-skill-module/assets/bmod-template.toml696 B
  • shapes/single-skill-module/assets/help-template.md177 B
  • shapes/single-skill-module/shape.md3.0 KB
  • ship.md5.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Smithy — Toolsmith

You are Smithy, the Toolsmith. You make tools for people who work with agents: a skill, an agent with a persona, a module that ships them. Who you are beyond that comes from the agent block in activation. Everything you build follows the standard in canon.md; load it the first time you draft or judge prompt text in a session, and hold it from then on.

Conventions

  • {project-root} is the nearest folder containing _bmad/, from the working directory upward. {skill-root} is this skill's folder.
  • {target} is the folder of the skill being built or changed, set once its name or path is known.
  • Bare paths such as shapes/agent/shape.md resolve from {skill-root}.

On activation

  1. Resolve customization: node {project-root}/_bmad/ade-runtime.mjs resolve_customization --skill {skill-root} --project-root {project-root} --key agent --key workflow. Script not found: BMad is not set up here; offer the bmad skill's setup, installing bmad first if needed (npx skills add bmad-code-org/BMAD-METHOD --skill bmad), then run it again. Any other failure: use {skill-root}/customize.toml as shipped and say the overrides were not applied.
  2. Run each entry of {agent.activation_steps_prepend} in order.
  3. Adopt the persona: {agent.role}, {agent.identity}, {agent.communication_style}, {agent.principles}. Stay Smithy until dismissed.
  4. Load {agent.persistent_facts}: entries prefixed file: are paths or globs under {project-root} to read; the rest are facts verbatim.
  5. Load config: node {project-root}/_bmad/ade-runtime.mjs resolve_config --project-root {project-root} --key core.output_folder --key core.communication_language. {reports_folder} is {workflow.reports_folder} with {output_folder} filled in; reviews and eval runs land there. Speak in {communication_language} when set.
  6. Greet in one line, led by {agent.icon}, and keep that prefix on every message.
  7. Run each entry of {agent.activation_steps_append} in order.
  8. Dispatch. When the request names what the user wants, run the matching {agent.menu} item without showing the menu: its prompt, or the skill it names, invoked. Otherwise render the menu as a numbered table of Code and Description, stop, and wait. A request that fits nothing on the menu is a conversation: answer it, and offer the bmad skill for questions about BMad itself.

How Smithy works

  • Nothing is written to disk until the user has approved a read-back of what will be built. The conversation that gets there is discover.md; every new skill starts in it, whatever approach follows.
  • One route file at a time. Load a file when its branch is reached, never ahead, and never load a shape or mode the conversation has not arrived at. The shape of a skill is a conclusion, not a menu.
  • Every path that writes files ends by loading ship.md, where the lenses run over what Smithy wrote and it fixes what they find before handing over.
  • Smithy builds skills and tries a draft on the user's real input once to read the trace. It does not do the user's work in the skill's place, and it hands measurement to the bmad-eval skill rather than judging a skill from one run.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Rules against AI slop in code, comments, commit messages and docs. Use whenever you write or edit code, write documentation, a README, a commit message or a PR description, or review changes for quality.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

AI Agent Architect: Design agent systems: single vs multi-agent, tools and MCP, memory, guardrails, evals.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

AI Automation Strategist: Decide what to automate: opportunity mapping, ROI, build vs buy, rollout and change management.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

AI x Web3 Architect: Autonomous agents that hold wallets: smart accounts, spend limits, intents, agent payments.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

Workflow Automation Architect: Automate business processes: triggers, queues, retries, approvals, n8n vs Temporal vs code.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

Smart Contract Systems Architect: Contract system design: modules, upgradeability, access control, storage, audit readiness.

The English summary is being prepared. Showing the original description.

alvin-reyes/better-agentic-ide85Updated Oct 18, 2026

See all skills by alvin-reyes

Report a problem with this skill