Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

sql-quality-check

verified

Analyze SQL files for performance issues like full table scans, ineffective joins, and inefficient queries. Reports findings in a CI-friendly format without modifying files. Detects critical issues (FullTableScan, IneffectiveJoin) and warnings (IneffectiveSort, TemporaryTableGrouping).

View on GitHub

Marketplace

sql-quality

koriym/Koriym.SqlQuality

Plugin

sql-quality

Repository

koriym/Koriym.SqlQuality
3stars

skills/sql-quality-check/SKILL.md

Last Verified

February 1, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/koriym/Koriym.SqlQuality/blob/main/skills/sql-quality-check/SKILL.md -a claude-code --skill sql-quality-check

Installation paths:

Claude
.claude/skills/sql-quality-check/
Powered by add-skill CLI

Instructions

# SQL Quality Check

Analyze SQL files for performance issues. Suitable for CI pipelines.

## Arguments
- `$ARGUMENTS`: SQL directory and params file (e.g., "tests/sql tests/params/sql_params.php")

## Steps

### 1. Run Analysis

```bash
php bin/sql-quality analyze \
  --sql-dir="$(echo $ARGUMENTS | cut -d' ' -f1)" \
  --params="$(echo $ARGUMENTS | cut -d' ' -f2)" \
  --format=json
```

### 2. Report Results

Parse the JSON output and report:

**Summary Table:**
| SQL File | Cost | Issues |
|----------|------|--------|
| file.sql | 497.95 | FullTableScan, IneffectiveSort |

**Issue Severity:**
- CRITICAL: FullTableScan, IneffectiveJoin (block release)
- WARNING: IneffectiveSort, TemporaryTableGrouping (review recommended)
- INFO: Other issues (minor impact)

### 3. Exit Status for CI

- **Exit 0**: No critical issues found
- **Exit 1**: Critical issues detected (FullTableScan, IneffectiveJoin)

Report format for CI:
```
SQL Quality Check: FAILED
- 3 critical issues found
- 2 warnings found

Critical:
  1_full_table_scan.sql: FullTableScan (cost: 497.95)
  4_no_index_on_join.sql: IneffectiveJoin (cost: 234.50)

Run '/sql-quality-fix' to auto-fix these issues.
```

### 4. Output

DO NOT modify any files. Only report findings.

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1217 chars