# Qodo Merge

> Configure and use Qodo Merge, formerly PR-Agent, for AI-powered pull request reviews, descriptions, inline suggestions, labels, docs, and ticket checks across GitHub, GitLab, Bitbucket, and Azure DevOps. Use this skill whenever the user mentions Qodo Merge, PR-Agent, `.pr_agent.toml`, `pr_agent`, PR review bots, `/describe`, `/review`, `/improve`, GitHub App or Action setup, model configuration,…

- **Type:** Skill
- **Install:** `agentstack add skill-aaronflorey-agent-skills-qodo-merge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aaronflorey](https://agentstack.voostack.com/s/aaronflorey)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [aaronflorey](https://github.com/aaronflorey)
- **Source:** https://github.com/aaronflorey/agent-skills/tree/main/skills/qodo-merge

## Install

```sh
agentstack add skill-aaronflorey-agent-skills-qodo-merge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Qodo Merge

Use this skill to install, configure, and troubleshoot Qodo Merge / PR-Agent without pulling large chunks of product docs into the active context.

## Start here

1. Identify the platform: GitHub Action/App, GitLab, Bitbucket, Azure DevOps, Docker, AWS Lambda, or self-hosted.
2. Identify the job: install, configure, use a tool command, switch models, or debug a failure.
3. Prefer repo-local `.pr_agent.toml` for stable settings and env vars only for secrets or one-off overrides.
4. Read only the reference file that matches the task instead of loading everything.

## Core commands

| Command | Use it for |
|---|---|
| `/describe` | Generate PR title, summary, walkthrough, labels, and optional diagram |
| `/review` | Review the PR for quality, correctness, security, and ticket alignment |
| `/improve` | Generate inline code suggestions and rank them by confidence |
| `/ask "..."` | Ask questions about the diff, files, or intent of the PR |
| `/add_docs` | Add missing docs for changed code |
| `/generate_labels` | Infer labels from PR content |
| `/help_docs "..."` | Answer repo questions from project documentation |

## High-value rules

- Config precedence is: CLI args -> env vars -> `.pr_agent.toml` -> defaults.
- For env var overrides, config keys map with double underscores, for example `PR_REVIEWER__REQUIRE_TESTS_REVIEW=false`.
- AWS Lambda env vars cannot contain `.`; use `__` instead.
- Non-OpenAI providers use their own API keys. Do not require `OPENAI_KEY` for Claude, Gemini, or similar providers.
- `suggestions_score_threshold` controls how aggressive `/improve` is; raise it to reduce low-value suggestions.
- `allow_dynamic_context = true` helps larger diffs by expanding surrounding code context.
- Use description markers when the user wants generated PR bodies to fit a repo template cleanly.
- Local Ollama setups generally require a self-hosted runner; hosted CI cannot reach local services.

## Troubleshooting shortcuts

| Symptom | First check |
|---|---|
| Model not found | Provider-specific model name format |
| API key missing | Matching secret/env var name for the selected provider |
| Permission denied | PR, issue, and contents write permissions in the integration |
| Bad JSON in provider config | `litellm.extra_body` formatting |
| Weak context on large PRs | Dynamic context and patch sizing settings |

## Routing guide

- Installation and platform-specific setup: `references/installation.md`
- Tool behavior and per-tool config: `references/tools.md`
- `.pr_agent.toml`, CLI flags, env vars, model wiring: `references/usage-guide.md`
- Self-reflection, compression, dynamic context, metadata: `references/core-abilities.md`
- Product overview, FAQ, and miscellaneous details: `references/other.md`
- Mirrored documentation index: `references/documentation/index.md`

## Working style

- Keep answers implementation-focused: pick the right platform path, show the minimal config, and explain only the options that matter to the user's case.
- Avoid dumping long examples from docs unless the user needs a ready-to-paste workflow or config block.
- Treat https://qodo-merge-docs.qodo.ai/ as the source of truth for exact option names and current behavior.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [aaronflorey](https://github.com/aaronflorey)
- **Source:** [aaronflorey/agent-skills](https://github.com/aaronflorey/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aaronflorey-agent-skills-qodo-merge
- Seller: https://agentstack.voostack.com/s/aaronflorey
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.