# quality

The quality skill formats Python code, runs lint and type checks, and validates pre-commit hooks. Use it to check a project before committing changes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 2 installs · ★ 492 repo stars
- Author: aiskillstore
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aiskillstore/marketplace/tree/HEAD/skills/byronwilliamscpa/quality/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/quality

## What it does

The skill groups several Python checks: Black and Ruff handle formatting, Ruff finds lint issues, BasedPyright checks types, and pre-commit runs every configured hook. Its command examples use `uv run`; the type-check command targets `src/`.

The rules cover an 88-character line limit, strict type checking, and checks for issues such as blind exception handling, logging formats, and private-member access. Tests and scripts get relaxed rules. Projects that do not use `uv` or these named tools will need adjusted commands.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill quality -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/quality/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/quality/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill quality -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/quality/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill quality -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/quality/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aiskillstore/marketplace skills/byronwilliamscpa/quality
```

2. **Manually: put the files in place**
- File: `.github/skills/quality/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill quality -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aiskillstore/marketplace --path skills/byronwilliamscpa/quality
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/quality/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill quality -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aiskillstore/marketplace/tree/HEAD/skills/byronwilliamscpa/quality/SKILL.md

## When to use it
- format Python files with Black and Ruff
- find lint issues with Ruff
- apply automatic Ruff fixes
- check types under `src/` with BasedPyright
- run every pre-commit hook

## Example prompts
- Format the Python code in this project using the quality skill's commands.
- Run Ruff on the project and apply the fixes it can make automatically.
- Check types in `src/`, then run all pre-commit hooks.

## Similar
- [black](https://affpapa.org/en/nevibecode/rules/black.md) — rule · ★ 3589 repo stars
- [python-code-quality](https://affpapa.org/en/nevibecode/skills/python-code-quality.md) — skill · 1100 installs
- [basedpyright-type-checking](https://affpapa.org/en/nevibecode/skills/basedpyright-type-checking.md) — skill · 357 installs
- [setup-formatting](https://affpapa.org/en/nevibecode/commands/setup-formatting.md) — command · 370 installs
- [gravitas-python](https://affpapa.org/en/nevibecode/skills/gravitas-python.md) — skill · 419 installs
- [quality-gates](https://affpapa.org/en/nevibecode/rules/quality-gates.md) — rule · ★ 2966 repo stars

## Other versions with the same name
- [quality · orwa-mahmoud](https://affpapa.org/en/nevibecode/skills/orwa-mahmoud-quality.md) — ★ 571 repo stars
- [quality · datawithbaraa](https://affpapa.org/en/nevibecode/skills/data-with-baraa-quality.md) — ★ 106 repo stars

From the same set: [aiskillstore/marketplace](https://affpapa.org/en/nevibecode/by/aiskillstore/marketplace.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
