bmad-skills

BMAD Skills Marketplace

A collection of skills for Claude Code that extend its capabilities with specialized knowledge and workflows.

What are Skills?

Skills are self-contained instruction sets that teach Claude Code how to perform specialized tasks. Each skill is defined in a SKILL.md file with optional supporting resources like scripts, templates, and reference documentation.

Repository Structure

<root>/
├── skills/                  # All skill implementations
│   └── [skill-name]/        # Individual skill folder
│       ├── SKILL.md         # Required - Main skill definition
│       ├── scripts/         # Optional - Supporting scripts
│       ├── references/      # Optional - Reference documentation
│       └── assets/          # Optional - Images, resources
├── template/                # Starter template for new skills
├── spec/                    # Skills specification documentation
├── CONTRIBUTING.md          # Contribution guidelines
└── README.md                # This file

Installation

Method 1: Install via skills CLI (Recommended)

The easiest way to install skills using the skills package. Supports Claude Code, Cursor, Codex, OpenCode, and 20+ other agents.

# Install all skills
npx skills add bmad-labs/skills

# Install specific skills for TypeScript development
npx skills add bmad-labs/skills --skill typescript-clean-code --skill typescript-e2e-testing --skill typescript-unit-testing

# Install to specific agent (e.g., claude-code, cursor, codex)
npx skills add bmad-labs/skills -a claude-code

# Install globally (user-level, available in all projects)
npx skills add bmad-labs/skills -g

Method 2: Install via Plugin Marketplace

This method installs the entire plugin with all skills automatically detected.

Step 1: Add the marketplace

/plugin marketplace add bmad-labs/skills

Step 2: Install the plugin

/plugin install bmad-labs@skills

Step 3: Verify installation

# Open the plugin manager to see installed plugins
/plugin

# Or ask Claude: "What skills are available?"

Method 3: Install via settings.json

Add to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "bmad-labs": {
      "source": {
        "source": "github",
        "repo": "bmad-labs/skills"
      }
    }
  },
  "enabledPlugins": {
    "bmad-labs@skills": true
  }
}

Method 4: Install Individual Skills

If you only need specific skills, add them individually to your project's .claude/settings.json:

{
  "skills": [
    "github:bmad-labs/skills/skills/clean-code",
    "github:bmad-labs/skills/skills/typescript-e2e-testing",
    "github:bmad-labs/skills/skills/typescript-unit-testing"
  ]
}

Available skill paths:

• github:bmad-labs/skills/skills/mcp-builder
• github:bmad-labs/skills/skills/typescript-e2e-testing
• github:bmad-labs/skills/skills/typescript-unit-testing
• github:bmad-labs/skills/skills/skill-creator
• github:bmad-labs/skills/skills/typescript-clean-code
• github:bmad-labs/skills/skills/book-converter
• github:bmad-labs/skills/skills/skill-from-book
• github:bmad-labs/skills/skills/ui-ux-pro-max
• github:bmad-labs/skills/skills/slides-generator
• github:bmad-labs/skills/skills/ai-multimodal
• github:bmad-labs/skills/skills/atlassian-rest
• github:bmad-labs/skills/skills/multi-repo-git-ops

Troubleshooting

If skills are not detected after installation:

1. Clear the plugin cache:

   rm -rf ~/.claude/plugins/cache
   

2. Restart Claude Code (exit and run claude again)

3. Verify skills are loaded:

   • Ask Claude: "What skills are available?"
   • Or run /plugin and check the Errors tab

4. Check plugin structure:

   claude plugin validate .
   

Using Skills

Invoking a Skill

Once installed, you can invoke skills using the slash command format:

/skill-name [arguments]

Or simply describe what you need - Claude will automatically use relevant skills based on their descriptions.

Creating New Skills

1. Copy the template/ folder to skills/your-skill-name/
2. Edit SKILL.md with your skill definition
3. Add any supporting scripts or references
4. Test the skill locally
5. Submit a PR

See CONTRIBUTING.md for detailed guidelines.

Skill Categories

Category	Description
Development	Coding, architecture, testing, DevOps
Productivity	Documents, project management, workflows
Creative	Design, content creation, branding
Data	Processing, analysis, visualization

Available Skills