How do I install the Quality Check skill?

Run npx skillmds@latest add matteocervelli/quality-check in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Quality Check safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Quality Check?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Quality Check free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Quality Check?

matteocervelli (@matteocervelli) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Quality Check by matteocervelli — Agent Skill

Name: Quality Check
Rating: 4.666666666666667 (3 reviews)
Author: matteocervelli

Quality Check

Multi-language code quality validation (Python, JS/TS, Shell, SQL) — formatting, linting, type-checking, complexity analysis with auto language detection. Use when checking code quality or running linters. Trigger on "lint", "type-check", "quality check", "run the linters", "check code quality".

File contents

Quality Check Skill

Purpose

Unified code quality validation across Python, JavaScript/TypeScript, Shell, and SQL. Runs formatting checks, linting, type checking, and complexity analysis.

Quick Start

# Auto-detect language and run appropriate checks
/quality-check [path]

Language Detection

The skill auto-detects language based on file extensions:

.py -> Python tools
.js, .ts, .tsx, .jsx -> JavaScript/TypeScript tools
.sh, .bash -> Shell tools
.sql -> SQL validation

Tool Matrix

Language	Formatter	Linter	Type Check	Complexity
Python	ruff format	ruff check	mypy	radon cc
JS/TS	prettier	eslint	tsc	eslint complexity
Shell	shfmt	shellcheck	-	-
SQL	-	sqlfluff	-	-
Swift	-	swiftlint	swift build	-
Go	gofmt	golint	go vet	-
Rust	rustfmt	clippy	-	-

Commands by Language

Python

# Format check (replaces black + isort)
ruff format --check src/ tests/

# Lint
ruff check src/ tests/

# Type check
mypy src/

# Complexity (functions with cc > 10)
radon cc src/ -nc

JavaScript/TypeScript

# Format check
npx prettier --check "src/**/*.{ts,tsx,js,jsx}"

# Lint
npx eslint "src/**/*.{ts,tsx}"

# Type check
npx tsc --noEmit

# Dependency audit
npm audit --production

Shell

# Lint
shellcheck scripts/*.sh

# Format check (if shfmt installed)
shfmt -d scripts/*.sh

SQL

# Lint (if sqlfluff installed)
sqlfluff lint queries/

Swift

# Lint
swiftlint

# Build check (type checking)
swift build

Go

# Format check
gofmt -d .

# Lint
golint ./...

# Vet (static analysis)
go vet ./...

Rust

# Format check
cargo fmt --check

# Lint
cargo clippy -- -D warnings

Quality Standards

All Languages

Metric	Threshold
File size	< 500 lines
Function size	< 50 lines
Complexity	< 10 per function
Nesting depth	< 4 levels

Python-Specific

Type hints on all functions
Google-style docstrings on public API
No bare except: clauses
No mutable default arguments

TypeScript-Specific

Strict mode enabled
Explicit return types
No any types (except justified)
No unused variables

Output Format

# Quality Report

**Status**: PASS/FAIL
**Files Checked**: N
**Language**: Python/TypeScript/Mixed

## Results

| Check      | Status | Issues           |
| ---------- | ------ | ---------------- |
| Format     | PASS   | 0                |
| Lint       | PASS   | 0                |
| Types      | PASS   | 0                |
| Complexity | WARN   | 2 functions > 10 |

## Issues Found

### Critical

[None or list]

### Warnings

- `src/utils.py:45` - complexity 12 (function `process_data`)

## Auto-fix Available

Run: `ruff format src/ && ruff check --fix src/`

Integration

This skill is called by /pre-commit as part of the full validation suite.

Troubleshooting

Tool Not Found

# Python
pip install ruff mypy radon

# JS/TS
npm install -D prettier eslint typescript

# Shell
brew install shellcheck shfmt  # macOS
apt install shellcheck shfmt   # Ubuntu

Too Many Errors

Focus on one category at a time:

Fix formatting first (auto-fixable)
Then linting (many auto-fixable)
Then type errors (manual)
Complexity last (refactoring)

---name: quality-checkdescription: Multi-language code quality validation (Python, JS/TS, Shell, SQL) — formatting, linting, type-checking, complexity analysis with auto language detection. Use when checking code quality or running linters. Trigger on "lint", "type-check", "quality check", "run the linters", "check code quality".--- # Quality Check Skill ## Purpose Unified code quality validation across Python, JavaScript/TypeScript, Shell, and SQL. Runs formatting checks, linting, type checking, and complexity analysis. ## Quick Start ```bash # Auto-detect language and run appropriate checks /quality-check [path] ``` ## Language Detection The skill auto-detects language based on file extensions: - `.py` -> Python tools - `.js`, `.ts`, `.tsx`, `.jsx` -> JavaScript/TypeScript tools - `.sh`, `.bash` -> Shell tools - `.sql` -> SQL validation ## Tool Matrix | Language | Formatter | Linter | Type Check | Complexity | | -------- | ----------- | ---------- | ----------- | ----------------- | | Python | ruff format | ruff check | mypy | radon cc | | JS/TS | prettier | eslint | tsc | eslint complexity | | Shell | shfmt | shellcheck | - | - | | SQL | - | sqlfluff | - | - | | Swift | - | swiftlint | swift build | - | | Go | gofmt | golint | go vet | - | | Rust | rustfmt | clippy | - | - | ## Commands by Language ### Python ```bash # Format check (replaces black + isort) ruff format --check src/ tests/ # Lint ruff check src/ tests/ # Type check mypy src/ # Complexity (functions with cc > 10) radon cc src/ -nc ``` ### JavaScript/TypeScript ```bash # Format check npx prettier --check "src/**/*.{ts,tsx,js,jsx}" # Lint npx eslint "src/**/*.{ts,tsx}" # Type check npx tsc --noEmit # Dependency audit npm audit --production ``` ### Shell ```bash # Lint shellcheck scripts/*.sh # Format check (if shfmt installed) shfmt -d scripts/*.sh ``` ### SQL ```bash # Lint (if sqlfluff installed) sqlfluff lint queries/ ``` ### Swift ```bash # Lint swiftlint # Build check (type checking) swift build ``` ### Go ```bash # Format check gofmt -d . # Lint golint ./... # Vet (static analysis) go vet ./... ``` ### Rust ```bash # Format check cargo fmt --check # Lint cargo clippy -- -D warnings ``` ## Quality Standards ### All Languages | Metric | Threshold | | ------------- | ----------------- | | File size | < 500 lines | | Function size | < 50 lines | | Complexity | < 10 per function | | Nesting depth | < 4 levels | ### Python-Specific - Type hints on all functions - Google-style docstrings on public API - No bare `except:` clauses - No mutable default arguments ### TypeScript-Specific - Strict mode enabled - Explicit return types - No `any` types (except justified) - No unused variables ## Output Format ```markdown # Quality Report **Status**: PASS/FAIL **Files Checked**: N **Language**: Python/TypeScript/Mixed ## Results | Check | Status | Issues | | ---------- | ------ | ---------------- | | Format | PASS | 0 | | Lint | PASS | 0 | | Types | PASS | 0 | | Complexity | WARN | 2 functions > 10 | ## Issues Found ### Critical [None or list] ### Warnings - `src/utils.py:45` - complexity 12 (function `process_data`) ## Auto-fix Available Run: `ruff format src/ && ruff check --fix src/` ``` ## Integration This skill is called by `/pre-commit` as part of the full validation suite. ## Troubleshooting ### Tool Not Found ```bash # Python pip install ruff mypy radon # JS/TS npm install -D prettier eslint typescript # Shell brew install shellcheck shfmt # macOS apt install shellcheck shfmt # Ubuntu ``` ### Too Many Errors Focus on one category at a time: 1. Fix formatting first (auto-fixable) 2. Then linting (many auto-fixable) 3. Then type errors (manual) 4. Complexity last (refactoring)

Frequently asked questions