AgentSkillsCN

qlty-check

通过qlty CLI进行代码质量检查、格式化和指标

SKILL.md
--- frontmatter
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

bash
# 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

ParameterDescription
--checkRun linters (default)
--fixAuto-fix issues
--allProcess all files, not just changed
--fmtFormat files instead
--metricsCalculate code metrics
--smellsFind code smells
--pathsSpecific files/directories
--levelMin issue level: note/low/medium/high
--cwdWorking directory
--initInitialize qlty in a repo
--pluginsList available plugins

Common Workflows

After Implementation

bash
# Auto-fix what's possible, see what remains
uv run python -m runtime.harness scripts/qlty_check.py --fix

Quality Report

bash
# 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

bash
uv run python -m runtime.harness scripts/qlty_check.py --init --cwd /path/to/repo

Direct CLI (if qlty installed)

bash
# 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

ToolUse Case
qltyUnified linting, formatting, metrics for any language
ast-grepStructural code patterns and refactoring
morphFast text search