qodo-skills

claude-plugins-official

developmentClaude Codeby anthropics

Summary

Qodo Skills provides a curated library of reusable AI agent capabilities that extend Claude's functionality for software development workflows. Each skill is designed to integrate seamlessly into your development process, enabling tasks like code quality checks, automated testing, security scanning, and compliance validation. Skills operate across your entire SDLC—from IDE to CI/CD—ensuring consistent standards and catching issues early.

Install to Claude Code

/plugin install qodo-skills@claude-plugins-official

Run in Claude Code. Add the marketplace first with /plugin marketplace add anthropics/claude-plugins-official if you haven't already.

README.md

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

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

View skill details

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-rules or $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 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_URLENVIRONMENT_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:

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

License

MIT License - see LICENSE file for details

Support

For issues with:

Related plugins

Browse all →