skill CX Codex

bmad-idea — Claude Code skill: one concept brief before planning

Q: How do I install bmad-idea in Claude Code?

Run `npx skills add akillness/jeo-skills --skill bmad-idea -a claude-code`. The skill lands at `~/.claude/skills/bmad-idea/SKILL.md`.

Q: How is bmad-idea different from bmad?

bmad-idea runs before planning and produces the concept. `bmad` handles phase routing once project framing exists.

Turns a rough idea into a single concept artifact and points to the next skill. Meant for the step before PRDs and sprint plans.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add akillness/jeo-skills --skill bmad-idea -a claude-code

Open on GitHub

What bmad-idea does

The skill picks one of five framing modes: problem, audience and value, concept shaping, game concept, or story packaging. It first normalises the incoming idea packet — domain, stage, audience, the biggest unknown. Then it returns exactly one artifact: problem brief, positioning brief, concept brief, game concept packet, or story / pitch packet.

Reference files ship with it: references/operating-modes.md for mode-selection heuristics, references/handoff-boundaries.md for routing to neighbouring skills, and references/concept-packet-template.md for output scaffolding. Tools allowed are Read, Write, Bash, Grep, Glob.

Mixing modes is off unless you ask for a two-pass workflow. Game ideas get pillars, player fantasy and a core loop before bmad-gds. If all you need is copy polishing with no framing decision, this is the wrong skill.

What it helps with

pin down which problem is actually worth solving
define audience and value before GTM work
collapse several half-ideas into one concept
sketch player fantasy, pillars and core loop
build a pitch packet for internal buy-in

Example prompts for the agent

I have a rough service idea — help me find the problem it solves
Shape a game concept: player fantasy, pillars, core loop
Put together a positioning brief for a new offer

How to install bmad-idea

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill bmad-idea -a claude-code

2Manually: put the files in place

~/.claude/skills/bmad-idea/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bmad-idea/

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill bmad-idea -a codex

2Manually: put the files in place

.agents/skills/bmad-idea/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill bmad-idea -a cursor

2Manually: put the files in place

.cursor/skills/bmad-idea/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install akillness/jeo-skills bmad-idea

2Manually: put the files in place

.github/skills/bmad-idea/SKILL.md

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill bmad-idea -a gemini-cli

2Platform CLI

gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/bmad-idea

Manually: put the files in place

.devin/skills/bmad-idea/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill bmad-idea -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about bmad-idea

How do I install bmad-idea in Claude Code?

Run npx skills add akillness/jeo-skills --skill bmad-idea -a claude-code. The skill lands at ~/.claude/skills/bmad-idea/SKILL.md.

What does bmad-idea do?

It cleans up an early-stage idea, picks a single framing mode, and produces one concept artifact ready for handoff.

How is bmad-idea different from bmad?

bmad-idea runs before planning and produces the concept. bmad handles phase routing once project framing exists.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set29

plannotator The skill opens a browser approval loop: a human reads a plan, diff or spec and leaves notes before any code gets written. CX Codex +1 379installs marketing-automation The skill turns a vague marketing request into one operating mode, one discipline and one operator packet with an owner and proof. CX Codex +1 377installs monitoring-observability Turns service, data-pipeline, or live-ops context into a monitoring brief with a primary mode, useful signals, and a small first implementation slice. CX Codex +1 369installs authentication-setup Walks you through choosing an auth lane for a web app or API and drawing the line between what the provider owns and what stays in your app. CX Codex +1 368installs state-management A skill that classifies React state into packets and picks the narrowest owner, so you stop arguing about libraries before you know what the state is. CX Codex +1 365installs sprint-retrospective Runs a sprint or milestone retrospective and turns it into a few owned actions instead of another template ritual. CX Codex +1 364installs debugging A skill that walks the agent through a reproduce → isolate → verify loop for concrete bugs, regressions and flaky failures. Useful once you already have a failing test or request. CX Codex +1 361installs git-submodule A skill that first asks whether a submodule is the right boundary, then walks you through one safe workflow. Useful when your project pulls in outside code through .gitmodules. CX Codex +1 360installs