code-review skill
This skill drives the code-review CLI / code-review-mcp MCP server from the
quality-triage project. The canonical contract is skills.md at the repo root.
When to use
- "Review this project / file", "find code smells", "find ML anti-patterns", "what's the technical debt here", "show complexity hotspots".
Setup (once)
uv sync # core
uv sync --extra mcp # if using the MCP server
Preferred: MCP tools
If the code-review MCP server is connected, call its tools directly:
detect_python_smells, detect_ml_smells, analyze_code_intelligence,
classify_technical_debt, list_python_files, read_file.
CLI fallback
code-review review <path-or-github-url> --output reports/review.md
code-review run-tool python-smells <path> --type all --format json
code-review run-tool ml-smells <path> --format json
code-review run-tool code-intel <path> --format json
code-review run-tool classify-td --text "TODO: ..." --category security
code-review doctor # verify environment / backends
code-review providers # show configured LLM providers
Output contract
- Executive summary
- Critical issues first, with
file:line:col - ML-specific issues
- Code quality & architecture issues
- Technical debt categories
- now/next/later remediation plan
Never invent commands, files, or tool names. Prefer the smallest command that
answers the question; escalate to a full review only when needed.
Source: KarthikShivasankar/quality-triage — distributed by TomeVault.