Codacy Skills

A collection of skills that teach your AI coding assistant how to use the Codacy CLI to improve code quality workflows.

Compatible with Claude Code, OpenAI Codex, GitHub Copilot, Gemini CLI, and any agent that supports the Agent Skills standard.

Skills

Requirements

• Codacy CLI installed (npm install -g @codacy/codacy-cloud-cli)
• Codacy Analysis CLI installed (npm install -g @codacy/analysis-cli)
• CODACY_API_TOKEN environment variable set (obtain from Codacy > My Account > Access Management > Account API Tokens) or use the codacy login command (interactive login)

Installation

Claude Code (recommended)

claude plugin marketplace add codacy/codacy-skills
claude plugin install codacy-skills@codacy

Run claude plugin update to stay on the latest version.

Claude.ai

1. Download the skill folder you want (e.g. codacy-cloud-cli/)
2. Zip it
3. Go to Claude.ai > Settings > Capabilities > Skills > Upload skill

OpenAI Codex

This repository follows the Agent Skills standard. Codex discovers skills from .agents/skills/ — the .agents/skills/ directory in this repo already points at each skill via symlinks, so cloning is enough:

git clone https://github.com/codacy/codacy-skills ~/.codacy-skills

# Per-project
ln -s ~/.codacy-skills/.agents/skills .agents/skills

# Or globally
ln -s ~/.codacy-skills/.agents/skills ~/.agents/skills

Run git -C ~/.codacy-skills pull to get updates.

GitHub Copilot

Copilot’s coding agent reads AGENTS.md from your repository root:

curl -o AGENTS.md https://raw.githubusercontent.com/codacy/codacy-skills/master/AGENTS.md

Gemini CLI

gemini extensions install https://github.com/codacy/codacy-skills.git --consent

Local development

If you installed the plugin from the marketplace, Claude Code will use the published version — not your local edits. To test local changes, use --plugin-dir to load the plugin directly from your working copy:

# from the repo directory
claude --plugin-dir .

# or from anywhere, using the path
claude --plugin-dir /path/to/codacy-skills

This bypasses the marketplace entirely. Your local SKILL.md files are what Claude sees.

Development workflow

1. Start Claude Code with --plugin-dir as above
2. Edit your skill files under skills/
3. Run /reload-plugins inside the session to pick up changes (no restart needed)
4. Test your skills

Avoiding conflicts with the marketplace version

If you have the marketplace plugin installed and want to be sure you’re always hitting local code, uninstall the marketplace copy:

claude plugin uninstall codacy-skills@codacy

Reinstall it when you’re done developing:

claude plugin install codacy-skills@codacy

See CONTRIBUTING.md for more on testing and submitting changes.

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.