skiller

Apply the same rules (and skills) to multiple AI coding agents.

npx skiller@latest init
npx skiller@latest install

Skills

• .agents/rules/*.mdc is local rule authoring
• .agents/skills/ is the canonical runtime skill tree
• skills-lock.json is the upstream source of truth for installed skills
• skiller install and skiller update use the local skills CLI, then auto-run apply
• skiller apply stays local and non-destructive
• See docs/skills.md

MCP

• Define MCP servers once in skiller.toml
• On apply, servers are propagated to all agents that support MCP
• See docs/mcp.md

Docs

• docs/cli.md — commands and flags
• docs/config.md — skiller.toml reference
• docs/skills.md — skills, propagation, plugin sync
• docs/mcp.md — MCP server config and propagation
• docs/troubleshooting.md — common failures and fixes
• docs/development.md — dev workflow
• docs/migration-from-ruler.md — notes for ruler users

Supported agents

| Identifier | Agent | Rules | MCP | Skills | | ---------------- | -------------- | -------------------------------------------------- | ------------------------------ | ------------------- | | github-copilot | GitHub Copilot | AGENTS.md | .vscode/mcp.json (servers) | .agents/skills | | claude-code | Claude Code | CLAUDE.md (@file refs) | .mcp.json | .claude/skills | | codex | Codex | AGENTS.md, .codex/config.toml | .codex/config.toml | .agents/skills | | cursor | Cursor | AGENTS.md | .cursor/mcp.json | .agents/skills | | windsurf | Windsurf | AGENTS.md | .windsurf/mcp_config.json | .windsurf/skills | | cline | Cline | .clinerules | - | .agents/skills | | openhands | OpenHands | .openhands/microagents/repo.md | config.toml | .openhands/skills | | gemini-cli | Gemini CLI | AGENTS.md, .gemini/settings.json | .gemini/settings.json | .agents/skills | | junie | Junie | .junie/guidelines.md | - | .junie/skills | | augment | Augment | .augment/rules/skiller_augment_instructions.md | - | .augment/skills | | kilo | Kilo Code | .kilocode/rules/skiller_kilocode_instructions.md | .kilocode/mcp.json | .kilocode/skills | | opencode | OpenCode | AGENTS.md, opencode.json | opencode.json | .agents/skills | | goose | Goose | .goosehints | - | .goose/skills | | crush | Crush | CRUSH.md, .crush.json | .crush.json | .crush/skills | | amp | Amp | AGENTS.md | - | .agents/skills | | qwen-code | Qwen Code | AGENTS.md, .qwen/settings.json | .qwen/settings.json | .qwen/skills | | kiro-cli | Kiro CLI | .kiro/steering/skiller_kiro_instructions.md | - | .kiro/skills | | warp | Warp | WARP.md | - | .agents/skills | | roo | Roo Code | AGENTS.md, .roo/mcp.json | .roo/mcp.json | .roo/skills | | trae | Trae | .trae/rules/project_rules.md | - | .trae/skills |