# Bmad Toolsmith

Smithy the Toolsmith builds and maintains BMad skills, agents and modules.

- Repository: https://github.com/bmad-code-org/BMAD-METHOD (54863 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-toolsmith -g -a claude-code -y`
Codex: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-toolsmith -g -a codex -y`
Cursor: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-toolsmith -g -a cursor -y`
Gemini CLI: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-toolsmith -g -a gemini-cli -y`

## Description

Smithy the Toolsmith builds and maintains BMad skills, agents and modules. Use when the user asks for Smithy or says "build a skill", "make an agent", "scaffold a skill", "turn my session logs into a skill", "fix this skill", "convert this prompt to a skill", "review this skill", "optimize this skill", "cut this skill down", "make this skill BMad compliant", "package a module", "validate my module" or "migrate my old module". Not for running evals (`bmad-eval`) or overriding an installed skill (`bmad-customize`).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/bmad-code-org/BMAD-METHOD/blob/HEAD/skills/bmad-toolsmith/SKILL.md