Align Recipe pyproject.toml
google/adk-recipes
Brings a Python recipe's pyproject.toml in line with the repo's CI rules, either as a read-only dry run or by rewriting the file while keeping comments.
Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent.
Install Code Quality
$ npx skills add notque/vexjoy-agent --skill code-quality -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install notque/vexjoy-agent code-quality --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/code-quality/code-quality .claude/skills/code-quality && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .claude/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-qualityType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add notque/vexjoy-agent --skill code-quality -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install notque/vexjoy-agent code-quality --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/code-quality/code-quality .agents/skills/code-quality && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .agents/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add notque/vexjoy-agent --skill code-quality -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install notque/vexjoy-agent code-quality --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/code-quality/code-quality .cursor/skills/code-quality && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .cursor/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/notque/vexjoy-agent.git --path skills/code-quality/code-quality--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add notque/vexjoy-agent --skill code-quality -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install notque/vexjoy-agent code-quality --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/code-quality/code-quality .gemini/skills/code-quality && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .gemini/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install notque/vexjoy-agent code-qualityInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add notque/vexjoy-agent --skill code-quality -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/code-quality/code-quality .github/skills/code-quality && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .github/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add notque/vexjoy-agent --skill code-quality -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install notque/vexjoy-agent code-quality --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/code-quality/code-quality .opencode/skills/code-quality && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "code-quality" agent skill from https://github.com/notque/vexjoy-agent/tree/main/skills/code-quality/code-quality into .opencode/skills/code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-quality", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
code-quality- GitHub stars
- 435
- Token cost
- ~1.5k tokens
- SKILL.md length
- 555 words
- Files
- 10 (incl. scripts, references)
- Skills in repo
- 61
- Repo updated
- First seen
- Licence
- MIT
At a glance
Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent.
- Tasks that involve Code quality
- SKILL.md covers Mode A: Cleanup, Mode B: Linting, Mode C: Python Quality Gate and Mode D: Universal Quality Gate, plus 1 more section
- Runs Python scripts from its folder; calls ruff, npx and make
- Tasks that involve Linting and formatting
What it does
Code Quality is an agent skill from notque/vexjoy-agent. Code quality: cleanup, linting, formatting, quality gates.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `references/biome-rules-reference.md`, `references/cleanup-report-template.md` and `references/cleanup-scan-commands.md`).
It sits in Development, covering Code quality, Linting and formatting and Quality gates. It works with Python and Ruff. The repository describes itself as: VexJoy AI Agent with Jev Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop. The licence is MIT.
When your agent uses it
- Tasks that involve Code quality
- Tasks that involve Linting and formatting
- Tasks that involve Quality gates
Example prompts
- “/code-quality”
Requirements
- Python 3
- Node.js
- Pre-approved tools (allowed-tools): Read, Write, Bash, Grep, Glob, Edit, Task, Skill
What it can do on your machine
Read from SKILL.md and the folder at commit 5218674. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteBashGrepGlobEditTaskSkill
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
ruffnpxmakepython3gitmypypytest
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx and git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Code Quality loads about 1.5k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 18 tokens; SKILL.md has 555 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Bash, Grep, Glob, Edit, Task, Skill
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from notque/vexjoy-agent at commit 5218674, republished under its MIT licence (© notque). 555 words, ~1,530 tokens.
Download SKILL.mdSave it as
.claude/skills/code-quality/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.- name
- code-quality
- description
- Code quality: cleanup, linting, formatting, quality gates.
- allowed-tools
- Read, Write, Bash, Grep, Glob, Edit, Task, Skill
- user-invocable
- true
- agent
- python-general-engineer
- routing.force_route
- true
- routing.not_for
- code review with findings (use review), security scanning (use security)
- routing.triggers
- code cleanup, clean up code, find dead code, stale TODOs, unused imports, remove dead code, find unused, tidy code, lint code, run ruff, run biome, format…
- routing.category
- code-quality
- routing.pairs_with
- review, testing, comment-quality
Code Quality
Four modes. Select by request signal:
| Signal | Mode |
|---|---|
| Dead code, stale TODOs, unused imports, technical debt | Cleanup |
| Lint Python/JS/TS, run ruff, run biome, format code | Linting |
| Python quality checks, ruff+pytest+mypy+bandit | Python Quality Gate |
| Multi-language quality gate, general "quality check" | Universal Quality Gate |
Default: Python-specific requests run Python Quality Gate. General requests run Universal Quality Gate.
Mode A: Cleanup
Scan for 9 categories of technical debt: stale TODOs, unused imports, dead code, missing type hints, deprecated functions, naming inconsistencies, high complexity, duplicate code, missing docstrings. Follow references/code-cleanup.md for the full 3-phase workflow (SCOPE, SCAN, REPORT).
Key principles:
- Read CLAUDE.md first for project conventions
- Scan only what was requested; ask for a target rather than scanning everything
- Exclude vendor/, node_modules/, .venv/, build/, dist/, generated/, .git/
- Prioritize findings by impact/effort: Quick Wins (auto-fixable, <5 min) > Important (bugs, security) > Polish (style)
- Apply auto-fixes only with explicit user permission; check first, fix, review diff, rerun checks
Mode B: Linting
Check or fix Python with Ruff and JavaScript/TypeScript with Biome. Read project instructions, pyproject.toml, and biome.json first; preserve configured rules.
| Task | Python | JavaScript/TypeScript |
|---|---|---|
| Check | ruff check . | npx @biomejs/biome check src/ |
| Format check | ruff format --check . | Included in Biome check |
| Fix lint | ruff check --fix . | npx @biomejs/biome check --write src/ |
| Format | ruff format . | npx @biomejs/biome format --write src/ |
Use project environment (./venv/bin/ruff). If configured, use make lint or make lint-fix. Check first; apply fixes only within requested scope. Review git diff, undo incorrect fixes, rerun checks. Do not change rules or install new tooling to get a pass.
Common fixes: F401 = remove/use import. I001 = sort imports. E501 = shorten lines. Biome noVar = use let/const. useConst = mark unchanged bindings.
Show full SKILL.md (283 more words)Show less
Mode C: Python Quality Gate
Run checks in order. Read repository configuration first; project commands and thresholds override defaults.
Detect: Find pyproject.toml, setup.py, .python-version. Check tool availability: ruff and pytest required; mypy and bandit optional unless project requires them.
Execute:
| Order | Command | Condition |
|---|---|---|
| 1 | ruff check . --output-format=grouped | Required |
| 2 | ruff format --check . | Required |
| 3 | mypy . --ignore-missing-imports --show-error-codes | If available |
| 4 | pytest -v --tb=short --cov=src --cov-report=term-missing | Coverage only when configured |
| 5 | bandit -r src/ -ll --format=screen | If available |
Run all checks even after one fails. Do not skip tests to get a pass.
Assess: Prioritize syntax/undefined errors, failing tests, security findings before style. Report per-tool status with actionable file:line diagnostics.
Fix: When authorized, run ruff check . --fix and ruff format ., review diff, rerun checks.
Mode D: Universal Quality Gate
Auto-detect languages and run configured checks. Read repository instructions first.
python3 ~/.claude/skills/code-quality/universal-quality-gate/scripts/run_quality_gate.pyOptions: --staged (pre-commit), --lang python (single language), --fix (apply fixes), -v (verbose).
Language detection uses hooks/lib/language_registry.json:
| Language | Markers | Tools |
|---|---|---|
| Python | pyproject.toml, requirements.txt | ruff, mypy, bandit |
| Go | go.mod | gofmt, golangci-lint, go vet |
| JavaScript | package.json | eslint, biome |
| TypeScript | tsconfig.json | tsc, eslint, biome |
| Rust | Cargo.toml | clippy, cargo fmt |
| Shell | *.sh | shellcheck |
A gate pass means required tools passed; it does not prove tests, builds, or business behavior passed.
Deep References
Load on demand when the signal matches.
| Signal | Reference | Content |
|---|---|---|
| Full cleanup workflow (9 categories) | references/code-cleanup.md | 3-phase cleanup: SCOPE, SCAN, REPORT |
| Language-specific scan commands | references/cleanup-scan-commands.md | Per-language commands and expected output |
| Cleanup report formatting | references/cleanup-report-template.md | Structured report template |
| Ruff rules, F401/E711/B006 | references/ruff-rules-reference.md | Ruff rule reference by category |
| Biome rules, ESLint migration | references/biome-rules-reference.md | Biome rule reference by category |
| Python quality tool commands | references/python-tool-commands.md | Detailed tool command options |
| Python quality report | references/python-report-template.md | Structured report template |
| pyproject.toml template | references/pyproject-template.toml | Tool configuration template |
© notque, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 9 other files (scripts, references) in skills/code-quality/code-quality of notque/vexjoy-agent.
- SKILL.md
- references/biome-rules-reference.md
- references/cleanup-report-template.md
- references/cleanup-scan-commands.md
- references/code-cleanup.md
- references/pyproject-template.toml
- references/python-report-template.md
- references/python-tool-commands.md
- references/ruff-rules-reference.md
- scripts/run_quality_gate.py
Open the folder on GitHubat commit 5218674
Compare with similar skills
Code Quality next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Code Quality this skillnotque/vexjoy-agent | 435 | — | ~1.5k | Automated safety check: Notes | MIT | |
| Align Recipe pyproject.tomlgoogle/adk-recipes | 10k | — | ~4.6k | Automated safety check: Pass | Apache-2.0 | |
| Cb Code QualityBlkLeg/CircuitBreaker | 201 | — | ~1.9k | Automated safety check: Pass | MIT | |
| ONNX Runtime Lintmicrosoft/onnxruntime | 22k | — | ~392 | Automated safety check: Pass | MIT | |
| Megatron-LM Linting and FormattingNVIDIA/Megatron-LM | 18k | — | ~317 | Automated safety check: Pass | Apache-2.0 | |
| Vibe Python Style Guidemistralai/mistral-vibe | 5.1k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Cb Code Quality
BlkLeg/CircuitBreaker
Circuit Breaker code conventions and the quality gates that actually block a push — ruff, mypy, eslint, the pytest coverage ratchet, and the make verify tiers.
- Official
ONNX Runtime Lint
microsoft/onnxruntime
Lints and formats C++ and Python code in the ONNX Runtime repository with lintrunner, clang-format and ruff, preferring a pass over only the changed files.
- Official
Megatron-LM Linting and Formatting
NVIDIA/Megatron-LM
Runs the Megatron-LM autoformat script and its linting tools before a pull request, and keeps Python imports in order with isort.
- Official
Vibe Python Style Guide
mistralai/mistral-vibe
Python conventions for the Mistral Vibe codebase covering style, strict typing, imports, Pydantic patterns, logging, error handling and file I/O.
Plankton Code Quality
affaan-m/ECC
使用Plankton进行编写时代码质量强制执行——通过钩子在每次文件编辑时自动格式化、代码检查和Claude驱动的修复。
More from notque/vexjoy-agent
All 61 skills in this repoGame Asset Generator
notque/vexjoy-agent
Deterministic palette/matrix pixel art (not AI). An agent skill from notque/vexjoy-agent.
PR Workflow
notque/vexjoy-agent
Pull request lifecycle: commit, codex review, sync, review, fix, status, cleanup, and PR mining.
Architecture Deepening
notque/vexjoy-agent
Improve architecture across modules by deepening interfaces.
Codebase Analyzer
notque/vexjoy-agent
Statistical rule discovery from Go codebase patterns. An agent skill from notque/vexjoy-agent.
Comment Quality
notque/vexjoy-agent
Review and fix temporal references in code comments. An agent skill from notque/vexjoy-agent.
Content
notque/vexjoy-agent
Content operations: editorial calendar, marketing, publishing, social media management.
Related
Categories
Questions about Code Quality
What does Code Quality do?
Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent. Code Quality is an agent skill from notque/vexjoy-agent. Code quality: cleanup, linting, formatting, quality gates.
When should I use Code Quality?
Code Quality fits situations like: tasks that involve Code quality; tasks that involve Linting and formatting; tasks that involve Quality gates.
How do I install Code Quality in Claude Code?
Run `npx skills add notque/vexjoy-agent --skill code-quality -a claude-code`. Or copy the skill folder (skills/code-quality/code-quality in notque/vexjoy-agent) into .claude/skills/code-quality in your project. Claude Code loads it when a task matches its description.
How do I install Code Quality in Codex?
Run `npx skills add notque/vexjoy-agent --skill code-quality -a codex`. Or copy the skill folder (skills/code-quality/code-quality in notque/vexjoy-agent) into .agents/skills/code-quality in your project. Codex loads it when a task matches its description.
Can I use Code Quality in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add notque/vexjoy-agent --skill code-quality -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-quality, .gemini/skills/code-quality, .github/skills/code-quality and .opencode/skills/code-quality in your project.
What does Code Quality need to run?
Going by SKILL.md and its folder, Code Quality needs Python for the scripts in its folder and the command-line tools its instructions call (ruff, npx, make, python3, git and mypy). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Read, Write, Bash, Grep, Glob, Edit, Task, Skill.
Does Code Quality access the network?
SKILL.md contains no URLs. Its commands use npx and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Code Quality safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Code Quality use?
Code Quality is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Code Quality use?
About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.
What are the alternatives to Code Quality?
Skills that share tags, products or a category with Code Quality: Align Recipe pyproject.toml (google/adk-recipes, 10k stars), Cb Code Quality (BlkLeg/CircuitBreaker, 201 stars), ONNX Runtime Lint (microsoft/onnxruntime, 22k stars) and Megatron-LM Linting and Formatting (NVIDIA/Megatron-LM, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Code Quality?
notque (a GitHub user) maintains it in notque/vexjoy-agent, which has 435 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 3, 2026.
Source: notque/vexjoy-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.