m3taz-ahmed/aizee / skills/bmad-toolsmith
bmad-toolsmith
VerifiedSmithy 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`).
modes/convert.md
View on GitHub# Convert
A skill or prompt from another tool becomes the smallest BMad skill that holds the same know-how, in the shape it needs.
## Read and extract
Read the source whole. Extract its outcome, who consumes it, when the author meant it to fire, the know-how a model would not have, any scripts, and what it depends on from its host.
## Drop
The canon's core test decides; keep only what prevents a failure. That drops:
- The host tool's mechanics, slash-command syntax and `$ARGUMENTS` included.
- Instructions the model already follows unasked.
## Frontmatter
BMad uses `name` and `description` only, not the agentskills.io spec's optional `license`, `compatibility`, `metadata` or `allowed-tools`: `description` is the whole trigger and `allowed-tools` is a host concern.
## Shape
Say the shape and the one line of why:
- A persona with a menu: an agent.
- Scripts doing most of the work: a script utility.
- A set of related commands: a module.
- Anything else, as most sources are: a plain skill.
## In place
When the source is already a skill folder and the user wants it brought to BMad rather than rebuilt beside it, work in that folder.
The execution plan lists what will change, and nothing is touched before approval:
- The name, kept unless the user wants their prefix on it.
- The description, rewritten to the canon.
- Paths and config reads, brought to `lenses/standards.md`.
- `bmod.toml` with both tables when the user wants a single-skill module, from `shapes/single-skill-module/shape.md`.
- What is dropped, by file.
- The passages the user wants kept word for word.
Then `ship.md`, where the lenses run over the result and their leanness findings are applied.
Skip discovery; the skill as it stands answers discovery's five questions.
## Hand-off
Load `discover.md` with the extraction as the mined input: discovery confirms the outcome, consumer and trigger phrases and asks only for what the source never said, usually the consumer, the near misses, and the name, since a source is usually named for its host.
From the execution plan on, the approach is lean.
Leave the source untouched; the user may still run it where it lives.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |