Getting Started

Installation

Run the following command inside your project root. The kit copies agents/, skills/, workflows/, configs/, prompts/, and rules/ directly into your working directory.

npx create-raffles-it

No global install needed. Every time you run it, the latest kit is fetched from npm.

your-project/
├── agents/                  ← 19 specialist agent definitions
│   ├── orchestrator/
│   │   ├── agent.yaml       ← model, tools, skills list
│   │   └── prompt.md        ← system prompt
│   ├── frontend-specialist/
│   ├── backend-specialist/
│   └── ...16 more
├── skills/                  ← 19 modular skill packs
│   ├── react-best-practices/
│   │   └── SKILL.md
│   ├── api-patterns/
│   └── ...17 more
├── workflows/               ← 11 slash command definitions
│   ├── create.md
│   ├── debug.md
│   └── ...9 more
├── configs/                 ← model & runtime config
├── prompts/                 ← shared prompt templates
└── rules/                   ← editor rules (Gemini, etc.)

Activate in your editor

# After running npx create-raffles-it, just open the project:
claude .

# macOS / Linux
cp -r agents/ ~/.claude/agents/

# Windows (PowerShell)
Copy-Item -Recurse agents\ $env:USERPROFILE\.claude\agents\

How auto-routing works

You never need to pick an agent manually. When you type a request, the AI reads your message, matches keywords and intent against the agent registry (agents/.agents), and silently loads the right agent and its skill packs.

The orchestrator agent handles multi-step tasks that span multiple domains by coordinating sub-agents in parallel.

Real-world examples

The skill tree

Skills are modular knowledge packs. Each agent lists which skills it uses in its agent.yaml. When an agent is activated, it reads those SKILL.md files and loads their rules, patterns, and scripts into context.

name: backend-specialist
model: claude-sonnet-4-6
tools:
  - Read
  - Grep
  - Bash
  - Edit
  - Write
skills:
  - clean-code           ← always-on coding standards
  - nodejs-best-practices
  - api-patterns         ← REST/GraphQL/tRPC patterns
  - database-design
  - lint-and-validate

# API Patterns Skill

## REST Design Rules
- Use noun-based resource URLs (/users, not /getUsers)
- Version APIs with /v1/ prefix
- Return 201 for POST creation, 204 for DELETE
- Always paginate list endpoints with cursor or offset

## Error Response Format
{
  "error": "RESOURCE_NOT_FOUND",
  "message": "User with id 123 does not exist",
  "statusCode": 404
}

## Input Validation
- Validate at controller layer with zod or joi
- Strip unknown fields before DB writes
- Return field-level errors for 422 responses

Slash command workflows

Workflows are multi-step orchestrated procedures. Invoke them by typing the slash command in Claude Code or your AI editor chat.

Direct invocation

Auto-routing handles most cases, but you can also call any agent or skill by name when you want precise control.

Quick reference

Which agent handles which task: