SkillsBrain

AI skills delivery for coding agents. Detect, generate, and install project-specific skills for Cursor, Claude, Windsurf, Devin, and 15+ platforms.

Quick Start

# Install globally
npm install -g skillsbrain

# Auto-detect your project and install skills
brain init

# Or install skills for a specific task
brain get "build a React dashboard with Supabase auth"

Or run without installing:

npx skillsbrain init

What It Does

SkillsBrain scans your project (dependencies, frameworks, file structure) and installs agent-ready skill files — not tutorials, but behavior instructions that coding agents actually follow.

Each skill includes:

• SKILL.md — rules, triggers, and anti-patterns for the agent
• scripts/ — validation and automation scripts
• references/ — installation guides and metadata

Commands

| Command | Description | |---------|-------------| | brain init | Auto-detect project stack and install matching skills | | brain get <description> | Install skills for a task description | | brain sync | Update stale skills, re-detect if project changed | | brain list | List installed skills | | brain remove <name> | Remove a skill | | brain login | Authenticate to sync with SkillsBrain web | | brain config set <key> <value> | Set API keys | | brain targets | List supported target platforms | | brain setup --global | One-time global setup (cache, shell hook) |

Setup

SkillsBrain requires API keys for skill detection and generation:

# Required: Cobrainer API (skill detection)
brain config set cobrainerApiKey cb-your-key

# Required: Anthropic API (skill generation)
brain config set anthropicApiKey sk-ant-your-key

# Optional: Supabase (web sync)
brain config set supabaseUrl https://your-project.supabase.co
brain config set supabaseAnonKey your-anon-key

Supported Platforms

Skills are generated for your target platform's native format:

| Platform | Flag | Output | |----------|------|--------| | SKILL.md (default) | --target skill_md | .agents/skills/*/SKILL.md | | Cursor | --target cursor | .cursor/rules/*.mdc | | Claude | --target claude_md | CLAUDE.md | | Windsurf | --target windsurf | .windsurfrules.md | | Devin | --target devin | .devin.md | | AGENTS.md | --target agents_md | AGENTS.md | | Cline | --target cline | .clinerules/*.md | | Roo Code | --target roo | .roo/rules/*.md | | Amazon Q | --target amazon_q | .amazonq/rules/*.md | | + 6 more | brain targets | — |

How It Works

1. Scan — reads your package.json, framework files, and project structure
2. Detect — sends a skill-oriented description to the Cobrainer knowledge graph
3. Generate — Claude creates project-specific behavior instructions (not generic docs)
4. Install — writes skill files to .agents/skills/ and updates AGENTS.md
5. Sync — keeps skills fresh as your project evolves (brain sync or cron)

License

MIT