qlty-check

by @namesreallyblank in Development

# Install this skill:

npx skills add namesreallyblank/Clorch --skill "qlty-check"

Install specific skill from multi-skill repository

# Description

Code quality checks, formatting, and metrics via qlty CLI

# SKILL.md

name: qlty-check
description: Code quality checks, formatting, and metrics via qlty CLI
allowed-tools: [Bash, Read]

Qlty 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.py wraps CLI
Config: .qlty/qlty.toml in repo (run qlty init first)

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

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.