From 79bfe1e977b372ecb3d5a0885db2c263909f7fe5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cl=C3=A1udia?= Date: Wed, 9 Sep 2026 14:47:05 +0100 Subject: [PATCH] docs: link each skill to its SKILL.md on GitHub Mark asked for each skill in the Available skills table to link to its source file so readers can read more about each one. Also simplify the table: the Needs column held "Both CLIs" on three of six rows and squeezed the Skill column enough to wrap the skill names, so the per-skill CLI requirement moves to Requirements as one sentence. Co-Authored-By: Claude Opus 5 --- docs/codacy-skills/index.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/codacy-skills/index.md b/docs/codacy-skills/index.md index 3d0ba68df4..cd8b8a6b59 100644 --- a/docs/codacy-skills/index.md +++ b/docs/codacy-skills/index.md @@ -10,14 +10,14 @@ The skills are open source under the MIT license and live in the [`codacy/codacy ## Available skills -| Skill | What it does | Needs | -|---|---|---| -| `codacy-cloud-cli` | Queries repositories, issues, security findings, pull requests, tools, and patterns on Codacy Cloud | Codacy Cloud CLI | -| `codacy-code-review` | Adds Codacy issues, security findings, coverage, and duplication to a pull request review | Both CLIs | -| `codacy-analysis-cli` | Runs static analysis locally, without sending your code to Codacy | Codacy Analysis CLI | -| `configure-codacy` | Discovers your project's stack, enables the tools and patterns that fit it, and cuts noise from the results | Both CLIs | -| `configure-codacy-cloud` | Tunes the configuration of a repository already analyzed on Codacy, without running local analysis | Both CLIs | -| `setup-coverage` | Detects your test framework and CI, then adds what's missing to generate and upload coverage reports | A repository on Codacy | +| Skill | What it does | +|---|---| +| [`codacy-cloud-cli`](https://github.com/codacy/codacy-skills/blob/master/skills/codacy-cloud-cli/SKILL.md) | Queries repositories, issues, security findings, pull requests, tools, and patterns on Codacy Cloud | +| [`codacy-code-review`](https://github.com/codacy/codacy-skills/blob/master/skills/codacy-code-review/SKILL.md) | Adds Codacy issues, security findings, coverage, and duplication to a pull request review | +| [`codacy-analysis-cli`](https://github.com/codacy/codacy-skills/blob/master/skills/codacy-analysis-cli/SKILL.md) | Runs static analysis locally, without sending your code to Codacy | +| [`configure-codacy`](https://github.com/codacy/codacy-skills/blob/master/skills/configure-codacy/SKILL.md) | Discovers your project's stack, enables the tools and patterns that fit it, and cuts noise from the results | +| [`configure-codacy-cloud`](https://github.com/codacy/codacy-skills/blob/master/skills/configure-codacy-cloud/SKILL.md) | Tunes the configuration of a repository already analyzed on Codacy, without running local analysis | +| [`setup-coverage`](https://github.com/codacy/codacy-skills/blob/master/skills/setup-coverage/SKILL.md) | Detects your test framework and CI, then adds what's missing to generate and upload coverage reports | The skills work together. Ask your assistant to review a pull request and it uses `codacy-code-review`, which in turn reaches for the two CLI skills to get local analysis and cloud coverage data. @@ -26,13 +26,15 @@ The skills work together. Ask your assistant to review a pull request and it use ## Requirements -Install the CLIs the skills you want depend on: +Most skills use both CLIs. Install them with: ```bash npm install -g @codacy/codacy-cloud-cli npm install -g @codacy/analysis-cli ``` +`codacy-cloud-cli` needs only the Codacy Cloud CLI and `codacy-analysis-cli` only the Codacy Analysis CLI. `setup-coverage` also needs the repository to be added to Codacy. + Then authenticate. Run `codacy login` and paste an [account API token](../codacy-api/api-tokens.md#account-api-tokens), or set the `CODACY_API_TOKEN` environment variable for non-interactive environments. Both CLIs read the same credentials from `~/.codacy/credentials`, so a single login covers both. See [Codacy Cloud CLI](../codacy-cloud-cli/index.md#authentication) for the full set of authentication options, including repository API tokens.