Skills › BMAD Method › bmod-toolsmith › references.md
references.md
19 lines · skills/bmod-toolsmith/help/references.md at bd70c64
1# Outside references
3Read this when the user asks where the official skill specification is, how a particular harness loads skills, or wants to read the sources BMad's conventions build on. Give the link and one line on what it covers; do not fetch pages to answer questions these help files already answer.
5| Resource | What it covers |
6|---|---|
7| Agent Skills specification: <https://agentskills.io/specification> | The open `SKILL.md` format BMad skills follow: `name` and `description` rules, optional keys, the `scripts/`, `references/` and `assets/` folders, progressive disclosure, the 500-line guidance. BMad uses `name` and `description` only and treats `allowed-tools` as the host's concern. |
8| Agent Skills overview: <https://agentskills.io/> | What skills are and which agents support the format. |
9| Anthropic, Agent Skills: <https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview> | The three-level loading model (metadata, instructions, resources on demand) and where skills work across Anthropic products. |
10| Anthropic, skill authoring best practices: <https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices> | Concise writing, degrees of freedom, third-person descriptions, one-level-deep references, building evaluations first. Several of BMad's canon rules are rewrites of these in BMad's terms. |
11| Anthropic skills repository: <https://github.com/anthropics/skills> | Example skills and the skill-creator skill whose eval loop the skill-creator approach follows. |
12| Claude Code skills: <https://code.claude.com/docs/en/skills> | Where Claude Code loads skills from, its frontmatter extensions such as `disable-model-invocation`, slash invocation, and dynamic context. |
13| Codex and ChatGPT skills: <https://learn.chatgpt.com/docs/build-skills> | How Codex loads skills from `.agents/skills`, explicit versus implicit invocation, and its description budget. |
14| Cursor rules: <https://cursor.com/docs/context/rules> | The `.mdc` rule format Smithy converts from: `alwaysApply`, `description` and `globs`. |
15| The `skills` CLI: <https://github.com/vercel-labs/skills> | `npx skills add`, the installer BMad uses, with its agent paths and options. |
16| Skills directory: <https://skills.sh/> | A directory of installable skills, useful for seeing what exists before building. |
17| Superpowers: <https://github.com/obra/superpowers> | A skills-based methodology whose writing-skills guidance informed some of BMad's rules. |
19BMad's own conventions are in these help files and in Smithy's canon; they do not require any page above to be read.
Outside references
Read this when the user asks where the official skill specification is, how a particular harness loads skills, or wants to read the sources BMad's conventions build on. Give the link and one line on what it covers; do not fetch pages to answer questions these help files already answer.
| Resource | What it covers |
|---|---|
| Agent Skills specification: <https://agentskills.io/specification> | The open SKILL.md format BMad skills follow: name and description rules, optional keys, the scripts/, references/ and assets/ folders, progressive disclosure, the 500-line guidance. BMad uses name and description only and treats allowed-tools as the host's concern. |
| Agent Skills overview: <https://agentskills.io/> | What skills are and which agents support the format. |
| Anthropic, Agent Skills: <https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview> | The three-level loading model (metadata, instructions, resources on demand) and where skills work across Anthropic products. |
| Anthropic, skill authoring best practices: <https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices> | Concise writing, degrees of freedom, third-person descriptions, one-level-deep references, building evaluations first. Several of BMad's canon rules are rewrites of these in BMad's terms. |
| Anthropic skills repository: <https://github.com/anthropics/skills> | Example skills and the skill-creator skill whose eval loop the skill-creator approach follows. |
| Claude Code skills: <https://code.claude.com/docs/en/skills> | Where Claude Code loads skills from, its frontmatter extensions such as disable-model-invocation, slash invocation, and dynamic context. |
| Codex and ChatGPT skills: <https://learn.chatgpt.com/docs/build-skills> | How Codex loads skills from .agents/skills, explicit versus implicit invocation, and its description budget. |
| Cursor rules: <https://cursor.com/docs/context/rules> | The .mdc rule format Smithy converts from: alwaysApply, description and globs. |
The skills CLI: <https://github.com/vercel-labs/skills> | npx skills add, the installer BMad uses, with its agent paths and options. |
| Skills directory: <https://skills.sh/> | A directory of installable skills, useful for seeing what exists before building. |
| Superpowers: <https://github.com/obra/superpowers> | A skills-based methodology whose writing-skills guidance informed some of BMad's rules. |
BMad's own conventions are in these help files and in Smithy's canon; they do not require any page above to be read.
Raw lines 1 to 19