About qlty-check
qlty-check is a skill for running code-quality checks through the qlty CLI. It is aimed at developers who need linting, formatting, and metrics across changed files or an entire repository, including automatic fixes and code-smell detection.
Key features
- 01Run linters and automatically fix issues
- 02Format code
- 03Calculate complexity and duplication metrics
- 04Find code smells
- 05Target paths and set issue levels
Use cases
- 01Check changed code before commit or handoff
- 02Automatically fix style and formatting issues
- 03Assess complexity and locate code smells
MCP support
The project mentions `servers/qlty/server.py` as a wrapper around the qlty CLI for MCP clients.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ parcadei/ continuous-claude-v3 --skill qlty-checkAfter installing, type/qlty-checkin Claude Code to confirm it loaded.
Details
From the project READMEQlty Code Quality
Universal code quality tool supporting 70+ linters for 40+ languages via qlty CLI.
When to Use
- Check code for linting issues before commit/handoff
- Auto-fix formatting and style issues
- Calculate code metrics (complexity, duplication)
- Find code smells
Quick Reference
# Check changed files with auto-fix
uv run python -m runtime.harness scripts/qlty_check.py --fix
# Check all files
uv run python -m runtime.harness scripts/qlty_check.py --all
# Format files
uv run python -m runtime.harness scripts/qlty_check.py --fmt
# Get metrics
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# Find code smells
uv run python -m runtime.harness scripts/qlty_check.py --smells
Parameters
| Parameter | Description |
|---|---|
--check | Run linters (default) |
--fix | Auto-fix issues |
--all | Process all files, not just changed |
--fmt | Format files instead |
--metrics | Calculate code metrics |
--smells | Find code smells |
--paths | Specific files/directories |
--level | Min issue level: note/low/medium/high |
--cwd | Working directory |
--init | Initialize qlty in a repo |
--plugins | List available plugins |
Common Workflows
After Implementation
# Auto-fix what's possible, see what remains
uv run python -m runtime.harness scripts/qlty_check.py --fix
Quality Report
# Get metrics for changed code
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# Find complexity hotspots
uv run python -m runtime.harness scripts/qlty_check.py --smells
Initialize in New Repo
uv run python -m runtime.harness scripts/qlty_check.py --init --cwd /path/to/repo
Direct CLI (if qlty installed)
# Check changed files
qlty check
# Auto-fix
qlty check --fix
# JSON output
qlty check --json
# Format
qlty fmt
Requirements
- qlty CLI: https://github.com/qltysh/qlty
- MCP server:
servers/qlty/server.pywraps CLI - Config:
.qlty/qlty.tomlin repo (runqlty initfirst)
vs Other Tools
| Tool | Use Case |
|---|---|
| qlty | Unified linting, formatting, metrics for any language |
| ast-grep | Structural code patterns and refactoring |
| morph | Fast text search |
Comments
Markdown supported