CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-deep-recon

Decision-grade research on a topic or this repository. Use when the user says "deep recon", "research this", "draft a research prompt", "process this research report", "market research", "domain research", "technical research", "competitor research", "what users say about X", "literature review", "help me choose between", "research the codebase", "research how X works here" or "why is X built this way". Not for a quick code question answered in chat.

Quality

92%

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

93%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 excellent orchestrator-style SKILL.md: telegraphic, command-dense, with a complete one-level-deep reference structure where every named file exists and a routing table that tells the reader exactly what to load per intent. The only soft spot is that the run-loop's validation checkpoints live entirely in the referenced files, leaving the body's own workflow slightly thinner on checkpoints than on executable commands.

DimensionReasoningScore

Conciseness

The body is dense and directive with zero padding: "Fast by default. Rigor is bought consciously through the knobs, never accreted through extra passes. One gate, light checkpoints, no ceremony." No concept Claude already knows is explained; every line instructs ("A claim is a sentence with a source. Publisher, publication date, access date. No naked numbers."). Matches the 5 anchor ("lean and efficient; assumes Claude's competence; every token earns its place"); 4 would require identifiable over-explanation to trim, and none is present.

5 / 5

Actionability

Copy-paste-ready commands with exact arguments: "uv run {project-root}/_bmad/scripts/memlog.py" with --type values enumerated, the resolve_customization.py and resolve_config.py invocations with --skill/--key flags, "npx skills add bmad-code-org/BMAD-METHOD --skill bmad", and "uv run {skill-root}/scripts/recon_kit.py tally {doc_workspace}/.memlog.md" for claim counts (never hand-counted). Concrete routing table, concrete failure paths, concrete JSON end-state. Matches the 5 anchor; not 4 because the executable commands present are complete rather than having minor gaps.

5 / 5

Workflow Clarity

The activation sequence is exemplary — numbered steps with explicit error-recovery feedback loops ("Script not found: BMad is not set up here. Offer to run the bmad skill's setup... then run the command again") and a named hard stop ("hold the plan gate — the one hard stop"), plus a resume-from-disk guarantee. But the core research loop's validation checkpoints are delegated rather than stated — "then run the loop" points at references/run.md and verification.md — so the body itself has minor checkpoint gaps, fitting anchor 4 rather than 5's fully-inline validation steps and checklists.

4 / 5

Progressive Disclosure

A textbook router: each intent in the table names exactly which files to load ("references/run.md, then references/verification.md + references/synthesis.md"), and every referenced file exists in the bundle (verified: draft.md, process.md, run.md, verification.md, synthesis.md, lifecycle.md, codebase.md, selection.md, finalize.md, plus scripts/recon_kit.py and assets/ templates). One level deep, clearly signaled, load-only-what-it-names. Matches the 5 anchor; no buried or nested references.

5 / 5

Total

19

/

20

Passed

Description

86%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.

An exemplary trigger description: explicit 'Use when' guidance with fourteen natural user phrases plus a negative boundary, in third-person voice. The main weakness is the capability statement itself — one abstract clause that never enumerates the concrete services (draft a prompt, process a report, run research, research the codebase) the skill actually delivers.

Suggestions

Enumerate the concrete services in the capability clause, e.g. "Drafts deep-research prompts for external tools, processes finished reports into cited summaries, runs native web research, and researches this codebase" — this moves specificity from abstract domain-naming to specific actions.

Keep the trigger list but trim near-duplicates ("research this" / "market research" / "domain research" / "technical research" / "competitor research" collapse to "market, domain, technical, or competitor research") to reduce length without losing coverage.

State the deliverable explicitly in the 'what' (a decision-grade, cited research artifact) so users know what they get, not just when to invoke.

DimensionReasoningScore

Specificity

The capability statement is a single abstract clause — "Decision-grade research on a topic or this repository" — and the only concrete actions ("draft a research prompt", "process this research report") appear as trigger quotes rather than capability descriptions; it never names the draft/process/run/codebase services it performs. Matches anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive"): not 4 because it does not list several specific actions; not 2 because it goes beyond naming the domain with a couple of concrete action phrases.

3 / 5

Completeness

Both halves are explicit: the "what" ("Decision-grade research on a topic or this repository") and a maximal "when" — "Use when the user says" plus 14 concrete trigger phrases and a negative boundary ("Not for a quick code question answered in chat"). Matches the 5 anchor (both what and when with concrete trigger phrases); 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Fourteen natural phrases users would actually say — "deep recon", "research this", "market research", "what users say about X", "literature review", "help me choose between", "why is X built this way" — covering synonyms, question forms, and codebase variants. Clearly the comprehensive-coverage anchor (5); no common variation is obviously missing, so 4's "a few natural terms missing" does not fit.

5 / 5

Distinctiveness Conflict Risk

A clear research niche with mostly distinct triggers, sharpened by the exclusion clause "Not for a quick code question answered in chat"; but "research the codebase", "research how X works here", and "literature review" could also plausibly route to general web-search or code-explainer skills. Fits anchor 4 ("mostly distinct; minor overlap risk with closely related skills"); not 5 because of that residual overlap with closely related skills, not 3 because the negative boundary and multi-trigger phrasing keep conflicts minor.

4 / 5

Total

17

/

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-deep-recon/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.