skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
sonarsource/sonarqube-agent-plugins68 installs

sonar-list-issues

Search and filter SonarQube issues for a project, branch, or pull request via sonarqube-cli (`-p` is always required on the CLI; resolve the key from user arguments or sonar-project.properties)

How do I install this agent skill?

npx skills add https://github.com/sonarsource/sonarqube-agent-plugins --skill sonar-list-issues
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a secure interface for listing SonarQube issues using the official CLI tool. It implements rigorous input validation and follows the principle of least privilege by restricting command execution to the vendor's specific tool.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

SonarQube — List Issues

Search for issues in a SonarQube project using the sonarqube-cli.

Unlike SonarQube MCP tools (which may use a default project from integration), sonar list issues always requires -p <project-key>. Resolve the key from the user-provided arguments or sonar-project.properties before running the CLI.

Usage

sonar-list-issues                                          # issues in the current project
sonar-list-issues my-project                               # issues in a specific project key
sonar-list-issues my-project --severities CRITICAL,BLOCKER # filter by severities
sonar-list-issues my-project --statuses OPEN,CONFIRMED     # filter by status
sonar-list-issues my-project --branch main                 # on a specific branch
sonar-list-issues my-project --pr 42                       # on a pull request
sonar-list-issues my-project --file src/auth/login.py      # for one file
sonar-list-issues my-project --file 'src/auth/login form.py' --new-code
sonar-list-issues my-project --new-code                    # only on new code

Prerequisites

This skill uses the sonarqube-cli command. The CLI must be installed and authenticated before proceeding.

Before proceeding, verify that sonar is available on your PATH and authenticated. If it is not, do not attempt to call any alternative commands or invent alternatives, and show the user:

Unable to list issues.

Possible causes:

  • sonarqube-cli not installed or not authenticated — invoke the sonar-integrate skill
  • Project key is wrong or missing — -p is mandatory for sonar list issues; invoke the sonar-list-projects skill or set sonar.projectKey in sonar-project.properties

Then ask the user (yes/no) whether to run the sonar-integrate skill now. Briefly explain what it does: it checks the SonarQube setup on their machine — installing or updating sonarqube-cli and verifying authentication — and re-configures the integration for this agent, including the SonarQube MCP server and secrets-scanning hooks. If they confirm, invoke the sonar-integrate skill yourself and follow it end-to-end in this session, then re-check and continue; if they decline, stop.

Instructions

Step 1: Resolve the project key

This flow uses sonar list issues (CLI), not MCP. The CLI always needs -p <project-key> — do not invoke it without a resolved key.

  • If the user provided a project key, use it.
  • Otherwise look for sonar.projectKey in sonar-project.properties at the repo root.
  • If still not found, do not run sonar list issues. Tell the user: "Invoke the sonar-list-projects skill to find your project key, then re-run with that key," or add sonar.projectKey to sonar-project.properties. (MCP integration defaults do not apply to this CLI command.)

Step 2: Parse optional flags from the user-provided arguments

FlagMaps to CLI option
--severities <values>--severities
--statuses <values>--statuses
--branch <name>--branch
--pr <id>--pull-request
--file <path>--file
--new-code--new-code (boolean flag, no value)

--branch and --pr are mutually exclusive — if both are provided, stop and ask which context to use. --file accepts a project-relative path or a unique filename. A directory path selects only that directory's own files, not files in subdirectories. --new-code limits results to the new code period and takes no value.

sonar list issues does not support filtering by issue type, rule, or tag, nor --component or --resolved flags. Only the options above (plus --format, --page, and --page-size) exist. For additional filtering, inspect the exposed schema of mcp__sonarqube__search_sonar_issues_in_projects and use only the parameters it supports.

Step 3: Validate arguments

Before building the command, validate each user-supplied value against the following rules. If any value fails validation, stop and tell the user what was rejected and why — do not run the command. Validate the resolved project key (from args or sonar-project.properties) against the project-key pattern before running the CLI.

ArgumentAllowed pattern
project key^[a-zA-Z0-9_\-\.:]+$
--severitiescomma-separated subset of: INFO, MINOR, MAJOR, CRITICAL, BLOCKER, HIGH, MEDIUM, LOW
--statusescomma-separated subset of: OPEN, CONFIRMED, FALSE_POSITIVE, ACCEPTED, FIXED
--branch^[a-zA-Z0-9_\-\./]+$
--prdigits only
--filenon-empty project-relative path or unique name matching ^[a-zA-Z0-9_.][a-zA-Z0-9_\-./ ]*$ (spaces are allowed)
--new-codeboolean flag only; reject any supplied value

Reject unknown flags and missing option values. For --file, this conservative pattern rejects shell metacharacters, quotes, and substitutions; explain rejected paths rather than altering them. Preserve accepted paths exactly, including spaces.

Step 4: Run sonar list issues

Build and run the command using a shell command. Always pass -p with the key resolved in Step 1. Single-quote the validated --file value so spaces remain part of one argument; do not interpolate an unvalidated path.

sonar list issues -p <project-key> --format toon [--severities <values>] [--statuses <values>] [--branch <name> | --pull-request <id>] [--file '<path>'] [--new-code]

Only include optional flags that were provided. Emit --new-code on its own, without a value.

Step 5: Format the results

If issues are found, present a summary line then a table sorted by severity then line number:

## SonarQube Issues — `my-project` (branch: `main`)

Found **12 issue(s)**:

| File                 | Line | Severity  | Rule         | Message                       |
| -------------------- | ---- | --------- | ------------ | ----------------------------- |
| src/auth/login.py    | 12   | 🔴 Blocker | python:S2077 | SQL injection risk            |
| src/utils/helpers.py | 34   | 🟠 High    | python:S2259 | Null dereference              |
| src/api/routes.py    | 67   | 🟡 Medium  | python:S3776 | Cognitive complexity too high |

Severity icons (the label depends on the server version):

  • 🔴 Blocker
  • 🟠 Critical / High
  • 🟡 Major / Medium
  • 🔵 Minor / Low
  • ⚪ Info

If no issues are found:

## SonarQube Issues — `my-project`

✅ No issues found.

Step 6: Next steps

  • To fix a specific issue: "Ask me to fix <rule> at <file>:<line>."
  • To check the quality gate: "Invoke the sonar-quality-gate skill."

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/sonarsource/sonarqube-agent-plugins/sonar-list-issues">View sonar-list-issues on skillZs</a>