Supported Agents
Skilz supports 14 AI coding assistants out of the box. Each agent has its own skills directory where skills are installed. This guide covers each agent's paths and support levels.
Remember: Install Skilz first with pip install skilz before installing skills to any agent.
Agent Overview
Key: Agents with ✓ Home Support can install skills at the user level (~/.agent/skills). Project Only agents only support project-level installation.
| Agent | User Path | Project Path | Support |
|---|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills | ✓ Home + Project |
| OpenCode | ~/.config/opencode/skills | .skilz/skills | ✓ Home + Project |
| Codex | ~/.codex/skills | .codex/skills | ✓ Home + Project |
| Universal | ~/.skilz/skills | .skilz/skills | ✓ Home + Project |
| Gemini | — | .skilz/skills | Project Only |
| GitHub Copilot | — | .github/copilot/skills | Project Only |
| Cursor | — | .skills/skills | Project Only |
| Windsurf | — | .skills/skills | Project Only |
| Aider | — | .skills/skills | Project Only |
| Zed AI | — | .skills/skills | Project Only |
| Qwen CLI | — | .skills/skills | Project Only |
| Kimi CLI | — | .skills/skills | Project Only |
| Crush | — | .skills/skills | Project Only |
| Plandex | — | .skills/skills | Project Only |
Agents with Home Support
These agents support user-level (global) skill installation. Skills installed at the user level are available across all your projects.
Claude Code
Anthropic's official CLI for Claude. The default agent for Skilz installations.
Paths
User: ~/.claude/skills
Project: .claude/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent claude Claude Code automatically loads skills from both directories. User-level skills are available globally.
OpenCode CLI
Open-source AI coding assistant with extensive customization options.
Paths
User: ~/.config/opencode/skills
Project: .skilz/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent opencode OpenAI Codex
OpenAI's Codex-powered coding assistant with native skill support.
Paths
User: ~/.codex/skills
Project: .codex/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent codex
Codex supports skill invocation via $skill-name or /skills.
Universal (Skilz)
A generic agent profile for tools that don't have specific configurations. Uses the standard Skilz directory structure.
Paths
User: ~/.skilz/skills
Project: .skilz/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent universal Project-Only Agents
These agents only support project-level installation. Skills must be installed within each project
where you want to use them. Use the --project flag to install.
Gemini CLI
Google's Gemini AI coding assistant. Project-only support.
Path
Project: .skilz/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent gemini --project GitHub Copilot
GitHub's AI pair programmer. Uses the .github/copilot directory structure.
Path
Project: .github/copilot/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent copilot --project Cursor
AI-first code editor built for pair programming with AI. Uses folder-based rules.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent cursor --project
Cursor uses folder-based rules via .cursor/rules/ for additional configuration.
Windsurf
Codeium's agentic IDE with deep codebase understanding.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent windsurf --project Aider
AI pair programming in your terminal with Git integration.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent aider --project
Aider uses CONVENTIONS.md for project-level configuration.
Zed AI
High-performance, multiplayer code editor with AI integration.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent zed --project Qwen CLI
Alibaba's Qwen-powered coding assistant.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent qwen --project
Qwen uses QWEN.md and CONTEXT.md for configuration.
Kimi CLI
Moonshot AI's Kimi coding assistant.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent kimi --project Crush
AI coding assistant with minimal configuration.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent crush --project Plandex
AI coding agent for complex, multi-file tasks.
Path
Project: .skills/skills Installing Skills
pip install skilzskilz install anthropics_skills/theme-factory --agent plandex --project Adding Custom Agents
If your AI coding assistant isn't in the list above, you can add it as a custom agent
in your configuration file at ~/.config/skilz/config.json:
{
"agents": {
"my_agent": {
"display_name": "My Custom Agent",
"home_dir": "~/.my-agent/skills",
"project_dir": ".my-agent/skills",
"config_files": ["AGENT.md"],
"supports_home": true,
"default_mode": "copy",
"native_skill_support": "none"
}
}
} See Configuration Reference for all available options.
See Also
- Configuration Guide — Custom agent paths
- Configuration Reference — Full config schema
- Commands — The
--agentoption