CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-ingest

Turns a transcript, thread, voice memo or long document into a cited note agents can act on. Use when the user says "ingest this", "process this transcript", "make notes from this thread or recording" or "what came out of this meeting".

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally lean, high-density process skill: explicit commands, naming conventions, validation checkpoints, and a full independent-review feedback loop with no wasted tokens. The only structural weakness is that it points at files outside its own bundle, which cannot be verified from the skill as shipped.

DimensionReasoningScore

Conciseness

The body is lean and instruction-dense with zero padding and no explanation of concepts Claude already knows — e.g., "Get dates and weekdays from `date` or `cal`, not from memory" and "Quote exactly where the wording carries weight: a commitment, a customer's own words". Every token earns its place (anchor 5); it is not a 4 because there are no trimmable over-explanations, and density never becomes verbosity.

5 / 5

Actionability

Guidance is fully executable: copy-paste commands (`uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.output_folder`, `npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), concrete naming schemes (`YYYY-MM-DD-<slug>` with `-2`, `-3` collision handling), enumerated citation forms ("a timestamp, a section, a message's date and speaker, or a short quote"), and a four-step fallback chain for choosing the note's folder. Per the rubric's code_vs_instruction note, absence of code in an instruction-only skill is not penalized; there are no material gaps, so it is not a 4.

5 / 5

Workflow Clarity

A clear sequence (activation → keep the raw → choose the template → write the note → review → finish) with explicit validation ("check that `source` and every relative link in the note resolve from the note's folder"), an independent-reviewer feedback loop with re-verification ("Check each finding against the raw before acting on it"), and error-recovery paths for missing scripts. This matches anchor 5's validation + feedback loops + checklist; it is not 4 because checkpoints are explicit rather than implicit, and the operation is neither destructive nor batch, so no cap applies.

5 / 5

Progressive Disclosure

Sections are well organized and detail is appropriately delegated at runtime (templates chosen by id, extensions loaded after, output folder resolved by priority list). However, the body references files outside the shipped bundle — `{skill-root}/customize.toml` and `{project-root}/_bmad/scripts/...` — and no references/, scripts/ or assets/ exist to verify them, and the ~68-line body exceeds the under-50-line simple-skill case. This fits anchor 4 ('good structure... minor organization gaps'); it is not 5 because referenced navigation targets are not present in the bundle, and well above 3 since nothing inlined clearly belongs in a separate file.

4 / 5

Total

19

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description that clearly states a concrete capability and pairs it with an explicit 'Use when' clause containing natural quoted triggers. Its main limitation is that it names one transformation rather than several concrete actions, and a couple of its triggers overlap with generic summarization requests.

Suggestions

Enumerate the concrete actions the transformation involves — e.g., 'cite every item to a timestamp, speaker or quote' and 'link attachments from the raw folder' — to lift specificity from one action to several.

Add natural trigger variants users commonly say for this task, such as "summarize this call" or "turn this into notes", to broaden keyword coverage.

Sharpen distinctiveness by naming the cited, traceable note output in the 'when' clause, which separates it from plain meeting-summarization skills.

DimensionReasoningScore

Specificity

The description names the domain concretely ("a transcript, thread, voice memo or long document") and one concrete transformation ("into a cited note agents can act on"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not list several distinct actions (e.g., citing items to timestamps, linking attachments, structuring frontmatter), and not a 2 because the action and output are specific rather than generic.

3 / 5

Completeness

It explicitly answers both questions: what ("Turns a transcript, thread, voice memo or long document into a cited note agents can act on") and when ("Use when the user says 'ingest this'...") with four concrete trigger phrases. This matches the 5 anchor exactly; it is not a 4 because the 'when' clause is fully explicit with quoted triggers rather than merely adequate.

5 / 5

Trigger Term Quality

It quotes four natural phrases a user would actually say — "ingest this", "process this transcript", "make notes from this thread or recording", "what came out of this meeting" — giving good keyword coverage. It falls short of the 5 anchor because common variants like "summarize this meeting/call" or "turn this into notes" are missing, and it is clearly above 3 since multiple natural phrasings are present.

4 / 5

Distinctiveness Conflict Risk

"ingest this" and "process this transcript" are distinct triggers for a clear raw-to-cited-note niche, but "what came out of this meeting" and "make notes from this thread" could plausibly overlap with meeting-summary or note-taking skills — minor overlap risk, matching anchor 4. It is not a 5 because that overlap is real, and well above 3 given the distinctive ingest framing.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bmad-code-org/BMAD-METHOD

Path

skills/bmad-ingest/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.