Dojo

⚡ Quick Start

# Install globally
npm install -g @opensourcewtf/dojo

# Search for skills
dojo search testing

# Install a skill
dojo learn test-generation

# Install an MCP server
dojo learn --mcp playwright

✨ Features

🤖 Supported Agents (21)

Dojo supports 21 AI coding assistants across three categories:

Core Agents

CAM-Compatible Agents

These agents are compatible with block/ai-rules:

Dojo-Exclusive Agents

Not supported by CAM—unique to Dojo:

Skill Formats

Detection: Dojo automatically detects installed agents by checking if their CLI is in your PATH.

📖 CLI Reference

dojo learn <skill> (alias: add)

Install a skill or MCP server to all detected agents.

dojo learn test-generation              # Install a skill
dojo learn --mcp playwright             # Install MCP server (auto-finds mcp-playwright)
dojo learn mcp-github --for claude      # Install only to Claude
dojo learn skill-name -g                # Install globally to ~/.dojo/skills

Options:

Modal Behavior: With --mcp, Dojo filters search results to only show skills with MCP servers and automatically finds mcp-<name> variants.

dojo search <query>

Search the skill registry. By default shows only skill files (excludes MCP-only entries).

dojo search testing             # Find testing skills
dojo search playwright --mcp    # Find MCP servers only
dojo search @anthropics         # Find skills by organization

Options:

dojo list (alias: ls)

Show installed skills or configured MCP servers.

dojo list                       # List installed skill files
dojo list --mcp                 # List configured MCP servers

Options:

dojo unlearn <skill> (alias: rm)

Remove a skill from agent directories.

dojo unlearn test-generation           # Remove skill from project
dojo unlearn skill-name -g             # Remove globally
dojo unlearn playwright --mcp          # Remove MCP config only (keep skill files)
dojo unlearn debugging -y              # Skip confirmation

Options:

Note: Use the exact MCP server name as shown in dojo list --mcp (e.g., playwright, not mcp-playwright).

dojo sync

Synchronize skills across all agent formats.

dojo sync              # Sync skills to all detected agents
dojo sync --force      # Overwrite existing skills

Options:

dojo cache <action>

Manage the local registry cache.

dojo cache info        # Show cache statistics
dojo cache clean       # Clear the cache

🔌 MCP Server Integration

Dojo includes its own MCP server for natural language skill discovery. Once configured, agents can respond to prompts like:

"Do you know how to write tests?"
"Teach me debugging"

Auto-Install via CLI

dojo learn --mcp dojo

This automatically configures the MCP server for all detected agents.

Manual Configuration

Claude (~/.claude.json):

{
  "mcpServers": {
    "dojo": {
      "command": "npx",
      "args": ["-y", "@opensourcewtf/dojo-mcp"]
    }
  }
}

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "dojo": {
      "command": "npx",
      "args": ["-y", "@opensourcewtf/dojo-mcp"]
    }
  }
}

📦 Packages

🗃️ Registry

Skills are sourced from the dojo-skills registry, cached via jsDelivr CDN for fast, reliable access.

Registry Categories:

• official/ — Skills from Anthropic, Google, OpenAI
• community/ — Community-contributed skills
• mcp/ — MCP server configurations

🛠️ Development

git clone https://github.com/OpenSourceWTF/dojo.git
cd dojo
pnpm install
pnpm build
pnpm test

Project Structure

packages/
├── cli/     # @opensourcewtf/dojo
└── mcp/     # @opensourcewtf/dojo-mcp

📄 License

MIT © OpenSourceWTF