Qodo Skills
Shift-left code review skills for AI coding agents. Bring Qodo's quality standards and code review capabilities into your local development workflow.
Compatible with: Claude Code, OpenAI Codex, Cursor, Windsurf, Cline, and any agent supporting the Agent Skills standard.
Available Skills
🔧 qodo-get-rules
Fetches the most relevant coding rules from Qodo for the current coding task. Generates a semantic search query from your assignment and retrieves only the rules that matter, ranked by relevance.
Features:
- 🔍 Semantic search — only the most relevant rules for your specific task
- ⚖️ Severity-based enforcement (ERROR, WARNING, RECOMMENDATION)
- 🎯 Dual-query strategy (topic + cross-cutting) for comprehensive coverage
- 🚀 Auto-runs before code generation, editing, and refactoring
🔍 qodo-pr-resolver
Fetch Qodo review issues for your current branch's PR/MR, fix them interactively or in batch, and reply to each inline comment with the decision.
Features:
- Multi-provider support (GitHub, GitLab, Bitbucket, Azure DevOps, Gerrit)
- Interactive issue review and auto-fix modes
- Per-issue inline comment replies and git commits
- Gerrit-native workflow: amend + push instead of per-fix commits
- Severity mapping from Qodo's action levels
- Automatic PR/MR/change summary comments
Installation
Install skills using the standard Agent Skills CLI:
# Install all Qodo skills
npx skills add qodo-ai/qodo-skills/skills
# Or install individual skills
npx skills add qodo-ai/qodo-skills/skills/qodo-get-rules
npx skills add qodo-ai/qodo-skills/skills/qodo-pr-resolver
Claude Code Marketplace:
/plugin install qodo-skills@claude-plugins-official
Works with:
- Claude Code - Skills available as
/qodo-get-rules,/qodo-pr-resolver - OpenAI Codex - Skills available from
/skills; invoke with$qodo-get-rulesor$qodo-pr-resolver - Cursor - Skills available in command palette
- Windsurf - Skills available in flow menu
- Cline - Skills available via skill invocation
- Any agent supporting agentskills.io
OpenAI Codex
Codex supports Agent Skills and discovers project skills from .agents/skills/ and user skills from $HOME/.agents/skills/. See the Codex Agent Skills documentation for Codex discovery behavior and invocation syntax.
To use Qodo skills with Codex, install with the Agent Skills CLI above if your skill manager is configured for Codex. For manual installation from a local checkout, copy the skill folders into a Codex-discovered skills directory. Use $HOME/.agents/skills/ for skills available across Codex workspaces, or .agents/skills/ for project-local skills available only in the current repository. Run these examples from the qodo-skills repository root, where ./skills/ exists.
macOS/Linux, Git Bash, or WSL:
# User-level install. For project-local install, set CODEX_SKILLS_DIR=".agents/skills".
CODEX_SKILLS_DIR="$HOME/.agents/skills"
mkdir -p "$CODEX_SKILLS_DIR/qodo-get-rules" "$CODEX_SKILLS_DIR/qodo-pr-resolver"
cp -R ./skills/qodo-get-rules/. "$CODEX_SKILLS_DIR/qodo-get-rules/"
cp -R ./skills/qodo-pr-resolver/. "$CODEX_SKILLS_DIR/qodo-pr-resolver/"
Windows PowerShell:
# User-level install. For project-local install, set $CodexSkillsDir = ".agents\skills".
$CodexSkillsDir = Join-Path $HOME ".agents\skills"
New-Item -ItemType Directory -Force "$CodexSkillsDir\qodo-get-rules", "$CodexSkillsDir\qodo-pr-resolver"
Copy-Item -Recurse -Force ".\skills\qodo-get-rules\*" "$CodexSkillsDir\qodo-get-rules"
Copy-Item -Recurse -Force ".\skills\qodo-pr-resolver\*" "$CodexSkillsDir\qodo-pr-resolver"
Codex also supports symlinked skill folders, but copying avoids path-dependent links if you later move the checkout.
Restart Codex if newly installed skills do not appear when running /skills inside Codex.
Agent-Specific Directories
Skills are automatically installed to the correct location for your agent:
| Agent | Installation Directory | |-------|----------------------| | Claude Code | ~/.claude/skills/ or .claude/skills/ | | OpenAI Codex | $HOME/.agents/skills/ or .agents/skills/ | | Cursor | ~/.cursor/skills/ or .cursor/skills/ | | Windsurf | ~/.windsurf/skills/ or .windsurf/skills/ | | Cline | ~/.cline/skills/ or .cline/skills/ |
Prerequisites
System Requirements
- Git - For repository detection
- Usually pre-installed on macOS and most Linux distributions
- Windows: Download from https://git-scm.com/download/win
- curl - For HTTPS API requests (works with system SSL certificates)
- Pre-installed on macOS, most Linux distributions, and Windows 10+
- If needed, install via package manager or download from https://curl.se
# Check installation
curl --version
# Install if needed:
# macOS: brew install curl (or use system curl)
# Ubuntu/Debian: apt-get install curl
# Windows 10+: Included by default
- Python 3.6+ - For JSON parsing and path manipulation only (no API calls)
- Pre-installed on macOS and most Linux distributions
- Windows: Download from https://www.python.org/downloads/
Note: All prerequisites use standard system tools with no external dependencies.
Configuration
qodo-get-rules Skill
Create ~/.qodo/config.json:
{
"API_KEY": "sk-xxxxxxxxxxxxx",
"ENVIRONMENT_NAME": "staging"
}
Configuration fields:
API_KEY(required): Your Qodo API keyENVIRONMENT_NAME(optional): Environment name for API URL- If empty/omitted: Uses
https://qodo-platform.qodo.ai/rules/v1/ - If specified: Uses
https://qodo-platform.<ENVIRONMENT_NAME>.qodo.ai/rules/v1/ QODO_API_URL(optional): Direct API base URL — overridesENVIRONMENT_NAME- Use for self-hosted, on-prem, or custom deployments
- Example:
"QODO_API_URL": "https://qodo.my-company.com" - The skill appends
/rules/v1internally; provide the base URL only
URL resolution priority: QODO_API_URL → ENVIRONMENT_NAME → production default
Get your API key at: https://app.qodo.ai/account/api-keys
Minimal configuration (production):
{
"API_KEY": "sk-xxxxxxxxxxxxx"
}
Custom deployment:
{
"API_KEY": "sk-xxxxxxxxxxxxx",
"QODO_API_URL": "https://qodo.my-company.com"
}
Environment variables (take precedence over config file):
export QODO_API_KEY="sk-xxxxxxxxxxxxx"
export QODO_ENVIRONMENT_NAME="staging" # optional
qodo-pr-resolver Skill
Requires CLI tools for your git provider:
- GitHub:
ghCLI (install guide) - GitLab:
glabCLI (install guide) - Bitbucket:
bbCLI - Azure DevOps:
azCLI with DevOps extension (install guide) - Gerrit:
curl+ SSH access to the Gerrit server (see Gerrit setup guide)
Usage
In Your Agent
After installation, invoke skills directly in your agent:
Claude Code:
/qodo-get-rules # Fetch coding rules
/qodo-pr-resolver # Fix PR review issues
OpenAI Codex: These are Codex chat commands, not terminal commands:
$qodo-get-rules # Fetch coding rules
$qodo-pr-resolver # Fix PR review issues
Cursor / Windsurf / Cline:
- Open command palette
- Search for "qodo-get-rules" or "qodo-pr-resolver"
- Or invoke via agent command input
Managing Skills
Update skills:
# Update individual skills
npx skills update qodo-ai/qodo-skills/skills/qodo-get-rules
npx skills update qodo-ai/qodo-skills/skills/qodo-pr-resolver
List installed skills:
npx skills list
Remove skills:
npx skills remove qodo-get-rules
Repository Structure
This repository follows the Agent Skills standard:
qodo-skills/
├── references/
│ └── usage-tracking.md # Shared HTTP headers for Qodo API calls
├── skills/
│ ├── qodo-get-rules/ # Fetch relevant coding rules skill
│ │ ├── SKILL.md # Agent Skills standard
│ │ ├── AGENTS.md # Skill-specific agent guidelines
│ │ └── references/ # Detailed reference docs
│ └── qodo-pr-resolver/ # Fix PR review issues skill
│ └── SKILL.md
├── README.md
├── CONTRIBUTING.md
└── LICENSE
How It Works
1. Skills are installed to agent-specific directories via npx skills add 2. Available for manual invocation in any compatible agent 3. Skills execute via their SKILL.md instructions
Testing Locally
Test with any agent:
npx skills add /path/to/qodo-skills/skills/get-qodo-rules
Troubleshooting
Skill not found?
Verify installation:
npx skills list | grep qodo
Reinstall if needed:
npx skills add qodo-ai/qodo-skills
Rules not loading?
Check you're in a git repository:
git status
Verify API key is configured:
cat ~/.qodo/config.json
Check Python is installed:
python3 --version || python --version
No rules found?
- Rules must be configured in the Qodo platform for your repository
- Visit https://app.qodo.ai to set up rules
- Check that your repository remote URL matches the configured scope
Windows-specific issues?
Python not found:
- Ensure Python 3.6+ is installed and in PATH
- Test:
python --versionorpy -3 --versionin PowerShell/cmd - Reinstall Python with "Add Python to PATH" option checked
Git not found:
- Install Git for Windows: https://git-scm.com/download/win
- Test:
git --versionin PowerShell/cmd
Path separators:
- The script automatically handles Windows backslashes (
\) vs Unix forward slashes (/) - API URLs always use forward slashes regardless of platform
Contributing
We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines:
1. Fork the repository 2. Create a feature branch (git checkout -b feature/my-feature) 3. Make your changes 4. Test thoroughly with your preferred agent (Claude Code, Cursor, etc.) 5. Submit a pull request
Resources
- Agent Skills Standard - Universal skill format
- npx skills CLI - Install and manage skills
- Qodo Platform - Set up coding rules and review
- Claude Code Documentation - Claude Code specific features
License
MIT License - see LICENSE file for details
Support
For issues with:
- Skills themselves: Open an issue in this repository
- Qodo Platform: Contact Qodo Support
- npx skills tool: See vercel-labs/skills
- Your agent: Refer to your agent's documentation (Claude Code, Cursor, Windsurf, etc.)






