Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

Code Quality Gate

A four-mode code quality skill: technical-debt cleanup, Ruff/Biome linting, a Python quality gate, and a multi-language gate.

Dev & CodingIntermediate42144AI score 9/10Last updated: Sep 19, 2026

What it does

The skill routes your request into one of four modes:

  • Cleanup — scans for 9 categories of technical debt (stale TODOs, unused imports, dead code, missing type hints, deprecated calls, naming drift, complexity, duplication, missing docstrings) and ranks findings as Quick Wins / Important / Polish.
  • Linting — Ruff for Python, Biome for JS/TS, honoring existing pyproject.toml and biome.json rules; never loosens rules just to pass.
  • Python Quality Gate — runs ruff check, ruff format --check, mypy, pytest (with coverage when configured), and bandit in order, continuing past failures and reporting file:line diagnostics.
  • Universal Quality Gate — detects Python, Go, JavaScript, TypeScript, Rust and Shell via marker files and runs each language's tools, with --staged, --lang, --fix and -v options.

Auto-fixes are applied only with explicit permission, followed by a git diff review and a re-run.

Who it's for

  • Python or JS/TS developers who want a repeatable pre-commit quality check.
  • Teams running polyglot monorepos that need one consistent gate.
  • Anyone inheriting a legacy codebase and needing a prioritized debt map.

Example uses

  1. "Find dead code and stale TODOs in src/" → Cleanup mode scopes the scan and emits a categorized report.
  2. "Run the Python quality gate before I commit" → ruff, format, mypy, pytest, bandit run in sequence with prioritized findings.
  3. "Lint only my staged files" → run_quality_gate.py --staged detects languages of changed files and runs the matching tools.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/notque/vexjoy-agent/HEAD/skills/code-quality/code-quality/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/code-quality/code-quality folder from the GitHub repo notque/vexjoy-agent into my ~/.claude/skills/code-quality/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/notque/vexjoy-agent.git /tmp/vexjoy-agent && mkdir -p ~/.claude/skills && cp -r /tmp/vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality

This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/notque/vexjoy-agent.git
  2. Create the skills directory: mkdir -p ~/.claude/skills
  3. Copy the skill: cp -r vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality
  4. Verify the bundled references/ folder and universal-quality-gate/scripts/run_quality_gate.py came along: ls -R ~/.claude/skills/code-quality
  5. Install the underlying tools: pip install ruff pytest mypy bandit (Python) and make sure Node.js is available for npx @biomejs/biome.
  6. Restart Claude Code and try a prompt like "run the python quality gate on this repo".