agentsclimarketplace

Codacy

Skill d-oit/do-web-doc-resolver/.agents/skills/codacy

LLM-ready web documentation resolver: Python cascade skill + web + Rust CLI (wdr) with semantic cache, multi-provider routing, and quality synthesis

Install
npx -y skills add d-oit/do-web-doc-resolver --skill codacy

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use Codacy static analysis CLIs to query PR analysis, triage issues, suppress false positives, and run local analysis. Use when Codacy blocks a PR, when asked to fix Codacy issues, suppress false positives, query PR quality data, or integrate Codacy into CI/CD workflows. Also use when the user mentions "Codacy", "static analysis check", "code quality gate", or "Codacy is failing".

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.3 KB, as published. Nobody here has run it

Codacy Static Analysis

Orchestrate static analysis using Codacy Analysis CLI (local) and Codacy Cloud CLI (remote).

Installation & Auth

npm i -g @codacy/analysis-cli @codacy/codacy-cloud-cli
export CODACY_API_TOKEN=<your-api-token>

PR Triage Workflow (NEVER SKIP ISSUES)

CRITICAL RULE: Never skip, suppress, or ignore Codacy issues without following this protocol.

  1. Get PR analysis: codacy pull-request gh <org> <repo> <prNumber> --output json > /tmp/codacy-pr.json
  2. For EACH issue, perform web research:
    • Search for the pattern ID against official documentation (ESLint, Biome, Semgrep, etc.)
    • Check the rule's purpose, severity, and whether it's enforced by coding standards
    • Determine if it's a genuine code quality concern or a false positive
    • Document findings with links to official docs
  3. Fix FIRST (always preferred):
    • If the issue is genuine, fix the code
    • Commit, push, re-verify with codacy pull-request --reanalyze-and-wait
  4. Ignore ONLY as last resort (verified false positive):
    • Only after web research confirms it's a false positive
    • Document WHY with links to official docs/best practices
    • Use codacy pull-request gh <org> <repo> <prNumber> --ignore-issue <numeric-resultDataId> --ignore-reason FalsePositive
    • Add inline comment explaining the rationale
  5. Verify: Confirm the fix or ignore resolves the issue without regressions

Local Analysis

codacy-analysis init --default
codacy-analysis analyze --pr --output-format json

Known Limitations

Tool CategoryStatusNote
JS/TS/Shell✅ WorksESLint, Stylelint, ShellCheck
Python/Rust❌ FailsMissing runtimes/venv issues or direct support in local CLI
Java/PMD❌ FailsMissing Java runtime

Always cross-reference with Cloud CLI for full PR data.

Rationalizations

RationalizationReality
"Local analysis shows 0 issues, so we are good."Analysis CLI has limited local tool support; Cloud CLI is the source of truth.
"I'll use the issue hash for suppression."Codacy CLI requires the numeric resultDataId for suppressions.

Red Flags

  • Relying solely on local codacy-analysis for Python/Rust projects.
  • Attempting to suppress issues without a valid --ignore-reason.
  • Ignoring the resultDataId field in JSON output in favor of hashes.
  • NEVER skip Codacy issues without web research against official docs.
  • NEVER assume an issue is false positive without verification.
  • NEVER ignore issues as a first response - always fix first.

References

  • references/output-format.md - JSON schema for PR analysis
  • references/supported-tools.md - Local vs Cloud tool availability
  • references/config-format.md - Codacy configuration file schema (.codacy.yml)

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.