К основному содержанию
скилл CX Codex

code-quality · bobmatnyc — скилл для Claude Code: проверка Python

Скилл code-quality для Claude Code проверяет Python-код на ошибки в исключениях, сравнениях, импортах и локальных переменных. Используется при ревью и самопроверке перед PR.

MIT 221 установок ★ 80 обновлён 2026-07-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bobmatnyc/claude-mpm-skills --skill code-quality -a claude-code
Открыть на GitHub

Что делает code-quality

code-quality разбирает шесть групп проблем в Python: неправильное наследование собственных исключений, сравнение None и других синглтонов через ==, слишком широкие обработчики, wildcard-импорты, неименованные числовые литералы и неиспользуемые локальные переменные. Он рассчитан на ревью и самопроверку, а не на запуск тестов или оценку здоровья всей кодовой базы.

Скилл подсказывает, как закрепить эти проверки через ruff, pylint и mypy в CI. Для каждой группы предусмотрены примеры нарушений и исправлений в quality-antipatterns.md. Если собственное исключение наследуется от object, его использование ломается при raise и в обработчиках except.

Доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. В Claude Code он устанавливается в ~/.claude/skills/code-quality/SKILL.md.

Какие задачи решает

  • проверить иерархию собственных исключений
  • найти сравнения None, True и False через ==
  • заменить широкие и пустые обработчики исключений
  • убрать wildcard-импорты и магические числа
  • найти присвоенные, но неиспользуемые локальные переменные

Примеры запросов агенту

  • Проверь этот Python-код на анти-паттерны качества и объясни каждое найденное нарушение.
  • Проведи самопроверку перед PR: найди широкие except, сравнения с None, wildcard-импорты и неиспользуемые локальные переменные.
  • Предложи правила ruff, pylint и mypy для этих проверок в CI.

Как установить code-quality

1Через Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill code-quality -a claude-code

2Вручную: положить файлы

~/.claude/skills/code-quality/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/code-quality/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о code-quality

Как установить code-quality в Claude Code?

Выполните npx skills add bobmatnyc/claude-mpm-skills --skill code-quality -a claude-code, затем проверьте файл ~/.claude/skills/code-quality/SKILL.md.

Что делает code-quality?

Скилл ищет в Python-коде ошибки в иерархии исключений, сравнениях синглтонов, обработке исключений, импортах, числовых литералах и локальных переменных.

Чем code-quality отличается от pytest и code-quality-scoring?

Он проверяет отдельные дефекты читаемости и корректности при ревью. pytest предназначен для механики тестирования, а code-quality-scoring оценивает здоровье и технический долг всей кодовой базы.

Исходный текст

SKILL.md · MIT
---
name: code-quality
description: "Python code-quality anti-patterns and review checks: exception-hierarchy correctness, singleton identity comparison, narrow exception handling, wildcard-import avoidance, magic-number naming, and dead-local removal. Use when reviewing or self-reviewing Python code for correctness and readability defects that linters and reviewers should catch."
user-invocable: false
disable-model-invocation: true
version: 1.0.0
updated: "2026-06-15"
category: toolchain
author: Claude MPM Team
license: MIT
progressive_disclosure:
  entry_point:
    summary: "Catch high-value Python code-quality anti-patterns in review: malformed exception classes, == None vs is None, bare except, wildcard imports, magic numbers, unused locals"
    when_to_use: "When reviewing or self-reviewing Python code for correctness/readability defects, configuring ruff/pylint rules, or writing code-quality guidance — not for testing mechanics (use pytest) or whole-codebase scoring (use code-quality-scoring)"
    quick_start: "1. Ensure custom exceptions derive from Exception 2. Compare None/True/False with is, not == 3. Catch the narrowest exception you can handle, never bare except 4. Replace wildcard imports with explicit names 5. Name magic numbers as constants 6. Remove unused locals — enforce all six with ruff/pylint/mypy in CI"
  references:
    - quality-antipatterns.md
context_limit: 600
tags:
  - python
  - code-quality
  - anti-patterns
  - code-review
  - pep8
  - ruff
  - pylint
  - static-analysis
requires_tools: []
---

# Python Code Quality

High-value Python code-quality anti-patterns to check during review or self-review.
This skill is **review-focused**: it covers correctness and readability defects that a
reviewer (or a linter) should flag, separate from testing mechanics (`pytest`) and
whole-codebase health scoring (`code-quality-scoring`).

> **Source note:** These anti-patterns are derived from CAST Highlight's Python code
> quality indicators (https://doc.casthighlight.com/), which reference **PEP 8** and the
> Python data model as primary sources. Where a rule mirrors PEP 8, the PEP is the
> authoritative source. All examples are original.

## When to Use This Skill

Use it when the task is **"is this Python code clean and correct?"** — for example:

- Reviewing a pull request and checking for the defects below.
- Self-reviewing before opening a PR.
- Configuring `ruff`/`pylint`/`mypy` rules so CI catches these automatically.
- Writing or updating a team's Python code-quality guidance.

Do **not** use it for testing mechanics (use the `pytest` skill) or for scoring a whole
codebase's health and technical debt (use the `code-quality-scoring` skill).

## Core Anti-Patterns (Summary)

Six highest-value Python anti-patterns. Each has a non-compliant/compliant example and a
"how to test" note in the reference doc:

- **Custom exceptions must derive from `Exception`** — a class meant to be raised that
  inherits from `object` fails at runtime and breaks every `except` clause.
- **Compare singletons with `is`, not `==`** — use `is`/`is not` for `None`/`True`/`False`
  (PEP 8); use `is` *only* for singletons, never for value comparison.
- **Avoid bare / overly broad `except`** — catch the narrowest type you can handle; a
  generic `except Exception` only as a last-position fallback that logs or re-raises.
- **Avoid wildcard imports** (`from x import *`) — they hide dependencies, risk silent
  name collisions, and defeat static analysis.
- **Replace magic numbers with named constants** — promote non-obvious literals to
  documented, named constants.
- **Remove unused local variables** — a dead assignment misleads readers and can hide a
  bug where a value was meant to be used.

## Best Practices

- **Gate these in CI.** Most are enforceable cheaply with `ruff` (F403/F405 wildcard,
  F841 unused locals, `E711`/`E712` singleton comparison), `pylint`, and `mypy`. Put the
  lint step in CI so review effort focuses on judgment, not mechanics.
- **Prefer specific exception handlers.** Order handlers narrowest-first; reserve a
  generic `except Exception` for a logging/re-raising last resort.
- **Name intent, not values.** A constant's *name* documents why a threshold exists; a
  bare literal documents nothing.

## Anti-Patterns (What to Avoid)

- Inheriting custom exceptions from `object` or directly from `BaseException`.
- `== None`, `== True`, or `is "some literal"`.
- Bare `except:` or `except BaseException:` that swallows control-flow signals.
- `from module import *` outside a curated `__init__.py` with explicit `__all__`.
- Unexplained numeric literals in business logic.
- Assigned-but-never-read locals left behind by a stale refactor.

## Navigation

- **[quality-antipatterns.md](references/quality-antipatterns.md)**: Full non-compliant
  vs compliant examples and a "how to test" note for each of the six anti-patterns.

## Related Skills

- **pytest** (`toolchains/python/testing/pytest`): testing mechanics — fixtures,
  parametrization, mocking. Several anti-patterns here (broad `except`, malformed
  exception classes) directly cause flaky tests.
- **code-review-standards** (`universal/process/code-review-standards`): the
  project-wide, severity-tagged review checklist that incorporates equivalents of these.
- **code-quality-scoring** (`universal/quality/code-quality-scoring`): whole-codebase
  health and technical-debt scoring, rather than individual findings.

© Claude MPM Team · MIT · bobmatnyc/claude-mpm-skills

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — code-quality от других авторов.

code-quality tursodatabase Скилл code-quality для Claude Code задаёт правила корректности, Rust-паттерны и принципы без переусложнения при написании кода в проекте. CX Codex +1 1 800установок code-quality miles990 Скилл code-quality направляет агента писать чистый код по принципам SOLID, избегать раздутых функций и оставлять комментарии только с контекстом решений. CX Codex +1 786установок code-quality cognitedata Скилл code-quality проводит ревью TypeScript- и React-кода, опираясь на линтер, строгую типизацию и проверку размеров компонентов. Пригодится перед созданием PR или после завершения фичи. CX Codex +1 2 000установок code-quality zernie Скилл code-quality для рефакторинга TypeScript и JavaScript: приводит типы в порядок, убирает невозможные состояния и разделяет логику с вводом-выводом. CX Codex +1 392установок Python Code Performance & Quality Enhancer sivasaiyadav8143 Промпт Python Code Performance & Quality Enhancer для ревью Python-кода: добавляет докстринги, чинит PEP8, ищет узкие места по скорости и отдаёт переписанный файл целиком. GP ChatGPT ★ 178 201звёзд репо python-anti-patterns Seth Hobson Скилл python-anti-patterns для Claude Code проверяет код по чек-листу типичных ошибок Python перед мержем и во время отладки. CX Codex +1 13 278установок python-patterns affaan-m Скилл python-patterns подсказывает агенту, как писать и ревьюить Python: идиомы, аннотации типов, обработка исключений, контекстные менеджеры. CX Codex +1 7 500установок python-code-review existential-birds Скилл python-code-review проверяет файлы Python на ошибки в типах, блокирующие вызовы в async-функциях и нарушение PEP8. Пригодится при подготовке пуллреквестов и чистке кодовой базы. CX Codex +1 958установок test-anti-patterns dotnet Скилл test-anti-patterns анализирует тесты на антипаттерны: пустые проверки, перехватанные исключения, зависимость от порядка, магические значения. Работает с любым языком — выдаёт отчёт с ранжированием по серьёзности. CX Codex +1 5 600установок m15-anti-pattern actionbook Скилл m15-anti-pattern ищет анти-паттерны в Rust-коде и предлагает более идиоматичные замены. Пригодится при ревью, рефакторинге и разборе проблем с владением. CX Codex +1 9 500установок

Из того же набора143

Весь набор →
api-review Скилл api-review для Claude Code — чек-лист безопасности API-эндпоинтов перед деплоем или слиянием пулл-реквеста. CX Codex +1 240установок jest Описывает настройку Jest для TypeScript: ts-jest, шаблоны тестов, моки модулей и покрытие. В проекте, который уже тестируется через Jest, помогает настроить эти инструменты. CX Codex +1 234установок code-review-standards Скилл code-review-standards задаёт чек-лист код-ревью с четырьмя уровнями серьёзности и выносит вердикт APPROVE, WARN или BLOCK — чтобы ревью не расползалось на вкусовщину. CX Codex +1 223установок prisma Справочник по Prisma ORM для TypeScript: готовые шаблоны схем, миграции, транзакции и синглтон клиента для Next.js. CX Codex +1 222установок react-core Скилл react-core для Claude Code даёт агенту базу по React для работы с компонентами и JSX, пропсами и состоянием, хуками, композицией, списками и контролируемыми полями ввода. CX Codex +1 220установок supabase Скилл учит агента настраивать клиент @supabase/supabase-js, писать запросы к Postgres через PostgREST и реализовывать авторизацию в Next.js, React или Vue. CX Codex +1 219установок nextjs Раскладывает переменные окружения Next.js по файлам .env* и объясняет, какое значение победит при запуске, сборке и деплое. CX Codex +1 212установок tauri Описывает паттерны событий Tauri: двустороннюю коммуникацию, потоки данных и обмен сообщениями между окнами. Показывает работу с real-time обновлениями в настольных приложениях. CX Codex +1 210установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой