Agent skill

Bmad Research

by aj-geddes in aj-geddes/claude-code-bmad-skills

Conducts market, competitive, domain, and technical research using live web sources, producing a cited research-report.md to inform BMAD planning decisions.

Custom licenceAuto-check: notesMarketing & SEO

Install Bmad Research

skills CLI
$ npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-research .claude/skills/bmad-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bmad-research
GitHub stars
488
Token cost
~1.6k tokens
SKILL.md length
554 words
Files
3 (incl. scripts)
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Conducts market, competitive, domain, and technical research using live web sources, producing a cited research-report.md to inform BMAD planning decisions.

  • Works in 7 steps: Clarify Intent → Plan the Research → Execute Research → …
  • The user says: - research [topic/market/technology] - competitive analysis
  • SKILL.md covers Step 0 — Clarify Intent, Step 1 — Plan the Research, Step 2 — Execute Research and Step 3 — Update Mode, plus 4 more sections
  • Runs Shell scripts from its folder

What it does

Bmad Research is an agent skill from aj-geddes/claude-code-bmad-skills. Conducts market, competitive, domain, and technical research using live web sources, producing a cited research-report.md to inform BMAD planning decisions. Use when the user says: - "research [topic/market/technology]" - "competitive analysis" or "who are the competitors" - "market size" or "market landscape" - "technical research" or "evaluate [technology/framework]" - "domain research" or "industry analysis" - "what does the market look like" - "find out about [technology/space]" - "I need research before we…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/research-sources.sh` and `templates/research-report.template.md`).

It sits in Marketing & SEO, covering Deep research, Competitor analysis and Market research. The repository describes itself as: BMAD Method skills for Claude Code - Auto-detection, Memory integration, Slash commands. Transform Claude Code into a BMAD-powered development environment.

When your agent uses it

  • The user says: - research [topic/market/technology] - competitive analysis
  • Who are the competitors - market size
  • Market landscape - technical research
  • Evaluate [technology/framework] - domain research

Example prompts

  • “research [topic/market/technology]”
  • “competitive analysis”
  • “who are the competitors”
  • “/bmad-research”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Clarify Intent
  2. Plan the Research
  3. Execute Research
  4. Update Mode
  5. Validate Mode
  6. Write the Report
  7. Handoff

What it can do on your machine

Read from SKILL.md and the folder at commit 27dca0e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • WebSearch
    • WebFetch
    • TodoWrite

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bmad Research loads about 1.6k tokens when it runs. Until then it costs about 223 tokens; SKILL.md has 554 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~223
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 554 words (~1,632 tokens).

“Conducts structured, cited research across three modes to feed BMAD planning workflows. Output is a research-report.md in bmad-output/, ready for handoff to planning skills.”

— opening of SKILL.md by aj-geddes, Custom licence
name
bmad-research
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in bmad-planning-orchestrator/skills/bmad-research of aj-geddes/claude-code-bmad-skills.

  • SKILL.md
  • scripts/research-sources.sh
  • templates/research-report.template.md

Open the folder on GitHubat commit 27dca0e

Compare with similar skills

Bmad Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bmad Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Research this skillaj-geddes/claude-code-bmad-skills488—~1.6kAutomated safety check: NotesCustom licence
Omk ResearchKaimingWan/oh-my-kiro107—~827Automated safety check: PassMIT
Consulting Analysisbytedance/deer-flow84k4 repos~8.4kAutomated safety check: PassMIT
Bmad Deep Recondelorenj/mcp-server-trello445—~2.3kAutomated safety check: PassMIT
Chatgpt Web Researchbear2u/my-skills932—~3.3kAutomated safety check: PassNone
Startup Designferdinandobons/startup-skill1.2k—~8.1kAutomated safety check: PassMIT

Similar skills

  • Omk Research

    KaimingWan/oh-my-kiro

    Multi-level research: built-in knowledge → web search → Tavily deep research API.

    107 GitHub stars~827 tokensUpdated 6 mo ago
    Marketing & SEOAuto-check passed
  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    84k GitHub starsUsed in 4 repos~8.4k tokens
    Marketing & SEOAuto-check passed
  • Bmad Deep Recon

    delorenj/mcp-server-trello

    Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…

    445 GitHub stars~2.3k tokensUpdated 17 days ago
    Research & ScienceAuto-check passed
  • Chatgpt Web Research

    bear2u/my-skills

    Use the user's already signed-in official ChatGPT website account, especially GPT-5.5 Pro / ChatGPT Pro, to perform product research, market research, competitor research, second-opinion research…

    932 GitHub stars~3.3k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Startup Design

    ferdinandobons/startup-skill

    Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub stars~8.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Money Discover

    iamzifei/show-me-the-money

    Discover profitable business ideas from scratch. An agent skill from iamzifei/show-me-the-money.

    1k GitHub stars~3.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from aj-geddes/claude-code-bmad-skills

All 20 skills in this repo
  • Bmad Architecture

    aj-geddes/claude-code-bmad-skills

    Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Brainstorm

    aj-geddes/claude-code-bmad-skills

    Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).

    488 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Builder

    aj-geddes/claude-code-bmad-skills

    Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Epics And Stories

    aj-geddes/claude-code-bmad-skills

    Solutioning flagship — shards a PRD + architecture into epics.md and individual {epic}.{story}.{slug}.story.md context objects, the LAST planning artifact before external dev handoff.

    488 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Help

    aj-geddes/claude-code-bmad-skills

    Orchestration spine and "what do I do next?" router for the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Init

    aj-geddes/claude-code-bmad-skills

    Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…

    488 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Bmad Research

What does Bmad Research do?

Conducts market, competitive, domain, and technical research using live web sources, producing a cited research-report.md to inform BMAD planning decisions. Bmad Research is an agent skill from aj-geddes/claude-code-bmad-skills.md to inform BMAD planning decisions.

When should I use Bmad Research?

Bmad Research fits situations like: the user says: - research [topic/market/technology] - competitive analysis; who are the competitors - market size; market landscape - technical research; evaluate [technology/framework] - domain research.

How do I install Bmad Research in Claude Code?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-research -a claude-code`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-research in aj-geddes/claude-code-bmad-skills) into .claude/skills/bmad-research in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Research in Codex?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-research -a codex`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-research in aj-geddes/claude-code-bmad-skills) into .agents/skills/bmad-research in your project. Codex loads it when a task matches its description.

Can I use Bmad Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-research, .gemini/skills/bmad-research, .github/skills/bmad-research and .opencode/skills/bmad-research in your project.

What does Bmad Research need to run?

Going by SKILL.md and its folder, Bmad Research needs a shell for the scripts in its folder. Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite.

Does Bmad Research access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Bmad Research safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bmad Research use?

Bmad Research has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Bmad Research use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bmad Research?

Skills that share tags, products or a category with Bmad Research: Omk Research (KaimingWan/oh-my-kiro, 107 stars), Consulting Analysis (bytedance/deer-flow, 84k stars), Bmad Deep Recon (delorenj/mcp-server-trello, 445 stars) and Chatgpt Web Research (bear2u/my-skills, 932 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Research?

aj-geddes (a GitHub user) maintains it in aj-geddes/claude-code-bmad-skills, which has 488 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 20, 2026.

Source: aj-geddes/claude-code-bmad-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.