rhiza-fr

Py Cq — Testing skill for Claude Code

Testing community

CLI that aggregates ruff, ty, bandit, pytest, radon + 6 more into a single token-efficient LLM prompt.

How to install Py Cq

This entry records only its repository, not the path inside it, so there is no exact command to give. Open rhiza-fr/py-cq and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Py Cq does

CLI that aggregates ruff, ty, bandit, pytest, radon + 6 more into a single token-efficient LLM prompt. CI gate + Claude Code hook.

Alternatives in Testing

Test Runner — Run Python tests with pytest, unittest, or other testing frameworks 23.4k ★
Sentient — Test prompt to showcase claude code hook blocking a dangerous rm -rf command 3.4k ★
Design QA — Visual QA on an HTML/CSS implementation — checks responsive behavior at mobile/tablet/desktop, design token co 309 ★

README

CQ - Python Code Quality Analysis Tool

[![CI](https://img.shields.io/github/actions/workflow/status/rhiza-fr/py-cq/ci.yml?label=CI)](https://github.com/rhiza-fr/py-cq/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/rhiza-fr/py-cq/graph/badge.svg)](https://codecov.io/gh/rhiza-fr/py-cq) [![PyPI version](https://img.shields.io/pypi/v/python-code-quality?)](https://pypi.org/project/python-code-quality/) [![Python versions](https://img.shields.io/pypi/pyversions/python-code-quality?)](https://pypi.org/project/python-code-quality/) [![License](https://img.shields.io/github/license/rhiza-fr/py-cq)](LICENSE)

Run 11+ code quality tools, aggregate results into one score, and surface the single most critical defect as a focused markdown prompt — ready to pipe to any LLM.

This can dramatically reduce the amount of noise for LLMs (and humans) and remove the need for them to know about these tools.

Note: It never edits your files. This is a job for you or an LLM. You may wish to run `ruff check --fix` and `ruff format` first.

cq check . -o llm     # top defect as markdown, pipe to an LLM
cq check .            # table overview of all scores
cq check . -o score   # numeric score only, exits 1 on errors (CI gate)

![cq demo](demo/output/demo.gif)

Install

# install the `cq` command line tool from PyPi
uv tool install python-code-quality

# or, clone it then install 
git clone https://github.com/rhiza-fr/py-cq.git
cd py-cq
uv tool install .

Tools

These tools are run in **parallel** except: When running '-o llm', we run sequentially and exit early at the first error. `coverage` is a special case: it starts alongside `pytest` and is cancelled if `pytest` fails, scoring `0%` without a second test run.