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 & CodingIntermediate★ 421⑂ 44AI 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.tomlandbiome.jsonrules; 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,--fixand-voptions.
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
- "Find dead code and stale TODOs in src/" → Cleanup mode scopes the scan and emits a categorized report.
- "Run the Python quality gate before I commit" → ruff, format, mypy, pytest, bandit run in sequence with prioritized findings.
- "Lint only my staged files" →
run_quality_gate.py --stageddetects 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)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the 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.
- Open a terminal and clone the repo:
git clone https://github.com/notque/vexjoy-agent.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality - Verify the bundled
references/folder anduniversal-quality-gate/scripts/run_quality_gate.pycame along:ls -R ~/.claude/skills/code-quality - Install the underlying tools:
pip install ruff pytest mypy bandit(Python) and make sure Node.js is available fornpx @biomejs/biome. - Restart Claude Code and try a prompt like "run the python quality gate on this repo".
View source on GitHub ↗License: MIT