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, 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

View skill details

🔍 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)
• Interactive issue review and auto-fix modes
• Per-issue inline comment replies and git commits
• Severity mapping from Qodo's action levels
• Automatic PR/MR summary comments

View skill details

Installation

Install skills using the standard Agent Skills CLI:

# Install all Qodo skills
npx skills add qodo-ai/qodo-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
• Cursor - Skills available in command palette
• Windsurf - Skills available in flow menu
• Cline - Skills available via skill invocation
• Any agent supporting agentskills.io

Agent-Specific Directories

Skills are automatically installed to the correct location for your agent:

Agent	Installation Directory
Claude Code	~/.claude/skills/ or .claude/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 key
• ENVIRONMENT_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 — overrides ENVIRONMENT_NAME
  • Use for self-hosted, on-prem, or custom deployments
  • Example: "QODO_API_URL": "https://qodo.my-company.com"
  • The skill appends /rules/v1 internally; 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: gh CLI (install guide)
• GitLab: glab CLI (install guide)
• Bitbucket: bb CLI
• Azure DevOps: az CLI with DevOps extension (install 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

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 --version or py -3 --version in 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 --version in 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.)