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

precommit-setup — скилл для Claude Code: что делает и как установить

Скилл precommit-setup настраивает трёхуровневую систему pre-commit хуков: линтинг, проверку типов и тесты перед каждым коммитом.

MIT 1 установок ★ 350 обновлён 2026-10-29

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

Что делает precommit-setup

Скилл разворачивает три слоя проверок: быстрые глобальные хуки (whitespace, синтаксис YAML/TOML/JSON, ruff, mypy) занимают 50-200мс, покомпонентные проверки lint/typecheck/test для изменённых частей монорепозитория идут 10-30 секунд, а дальше запускаются кастомные хуки валидации структуры и паттернов проекта. Порядок фиксирован: сначала проверка файлов и bandit, затем глобальный линт и typecheck, потом покомпонентные проверки, в конце — валидация.

Настройка включает создание .pre-commit-config.yaml через attune_init.py, конфигурацию pyproject.toml со строгим mypy (strict = true) и секцией tool.pytest.ini_options, установку хуков через uv run pre-commit install. Для монорепозиториев и плагинных архитектур скилл предлагает стандартизировать Makefile-таргеты lint, typecheck, test на каждый компонент и выносить общие настройки в корневой pyproject.toml.

Проверка готовности завязана на uv — команды установки и прогона хуков написаны через uv run и uv sync --extra dev.

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

  • настроить pre-commit хуки с нуля в новом проекте
  • перейти от базового линтинга к полноценной системе качества
  • добавить покомпонентные проверки lint/typecheck/test в монорепозитории
  • настроить строгую проверку типов mypy в pyproject.toml
  • синхронизировать CI-проверки с локальными pre-commit хуками

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

  • Настрой pre-commit хуки для этого Python-проекта по трёхуровневой схеме
  • Добавь покомпонентные lint и typecheck скрипты для монорепозитория в scripts/
  • Сгенерируй .pre-commit-config.yaml и подключи строгий mypy в pyproject.toml

Как установить precommit-setup

1Через Skills CLI (Vercel)

npx skills add athola/claude-night-market --skill precommit-setup -a claude-code

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

~/.claude/skills/precommit-setup/SKILL.md

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

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

Вопросы о precommit-setup

Как установить precommit-setup в Claude Code?

Выполните npx skills add athola/claude-night-market --skill precommit-setup -a claude-code, после чего скилл появится в ~/.claude/skills/precommit-setup/SKILL.md.

Что делает precommit-setup?

Скилл настраивает трёхуровневую систему pre-commit хуков: глобальный линтинг и typecheck, покомпонентные проверки для изменённых частей монорепозитория и кастомную валидацию структуры проекта.

В каком порядке выполняются хуки после установки?

Сначала проверка файлов и синтаксиса, затем bandit, глобальный ruff и mypy, далее покомпонентные lint/typecheck/test и в конце кастомная валидация — все шаги должны пройти для успешного коммита.

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

SKILL.md · MIT
---
name: precommit-setup
description: Configures pre-commit hooks for linting, type checking, formatting, and testing. Use when setting up a new project or adding quality gates to an existing one.
globs: "**/.pre-commit-config.yaml"
alwaysApply: false
# Custom metadata (not used by Claude for matching):
tools:
- Read
- Write
- Bash
category: infrastructure
tags:
- pre-commit
- quality-gates
- linting
- type-checking
- testing
complexity: intermediate
model_hint: standard
estimated_tokens: 1800
progressive_loading: true
modules:
- modules/standard-hooks.md
- modules/component-level-hooks.md
- modules/validation-hooks.md
- modules/ci-integration.md
- modules/troubleshooting.md
---

# Pre-commit Setup Skill

Configure a three-layer pre-commit quality system that
enforces linting, type checking, and testing before every
commit.

## When To Use

- Setting up a new project with code-quality enforcement
- Adding pre-commit hooks to an existing project
- Upgrading from basic linting to a full quality system
- Setting up monorepo or plugin architecture with
  per-component quality checks
- Updating pre-commit hook versions

## When NOT To Use

- Pre-commit hooks already configured and working optimally
- Project does not use git version control
- Team explicitly avoids pre-commit hooks for workflow reasons

## Philosophy: Three-Layer Defense

The system is organised in three layers, each with a
different cost / coverage tradeoff:

- **Layer 1: Standard hooks**: fast global checks
  (50-200ms total). Lints and type-checks every staged file.
- **Layer 2: Component-specific checks**: per-component
  lint, typecheck, and test (10-30s total). Only the
  components touched by the staged files are run.
- **Layer 3: Validation hooks**: project-specific
  structure and pattern checks (varies). Catches violations
  that generic linters miss.

This layering keeps the fast feedback loop fast while still
catching the slow / project-specific bugs before they land.

## Module Loading

The detailed configuration patterns are in modules; load
only the ones you need:

- `modules/standard-hooks.md`: Layer 1 patterns for
  Python, Rust, and TypeScript (load when configuring base
  linters).
- `modules/component-level-hooks.md`: Layer 2 monorepo
  scripts and pre-commit wiring (load when project has
  multiple components / plugins).
- `modules/validation-hooks.md`: Layer 3 custom hooks
  and SKIP patterns (load when enforcing project conventions
  beyond linting).
- `modules/ci-integration.md`: GitHub Actions workflow
  plus a complete `.pre-commit-config.yaml` example (load
  when wiring CI to mirror local checks).
- `modules/troubleshooting.md`: timing tables, cache
  clearing, hook-failure recovery (load when hooks are slow
  or failing).

## Workflow

### 1. Create Configuration Files

\`\`\`bash
# Create .pre-commit-config.yaml
python3 plugins/attune/scripts/attune_init.py \\
  --lang python \\
  --name my-project \\
  --path .

# Create quality check scripts (for monorepos)
mkdir -p scripts
chmod +x scripts/run-component-*.sh
\`\`\`

### 2. Configure Python Type Checking

Create `pyproject.toml` with strict type checking:

\`\`\`toml
[tool.mypy]
python_version = "3.12"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
strict = true

# Per-component configuration
[[tool.mypy.overrides]]
module = "plugins.*"
strict = true
\`\`\`

### 3. Configure Testing

\`\`\`toml
[tool.pytest.ini_options]
testpaths = ["tests"]
pythonpath = ["src"]
addopts = [
    "-v",                    # Verbose output
    "--strict-markers",      # Strict marker enforcement
    "--cov=src",             # Coverage for src/
    "--cov-report=term",     # Terminal coverage report
]

markers = [
    "slow: marks tests as slow (deselect with '-m \\"not slow\\"')",
    "integration: marks tests as integration tests",
]
\`\`\`

### 4. Install and Test Hooks

\`\`\`bash
# Install pre-commit tool
uv sync --extra dev

# Install git hooks
uv run pre-commit install

# Test on all files (first time)
uv run pre-commit run --all-files

# Normal usage - test on staged files
git add .
git commit -m "feat: add feature"
# Hooks run automatically
\`\`\`

### 5. Create Manual Quality Scripts

For full quality checks (CI/CD, monthly audits):

\`\`\`bash
#!/bin/bash
# scripts/check-all-quality.sh: full quality check for all components

set -e

echo "=== Running Full Quality Checks ==="

./scripts/run-component-lint.sh --all
./scripts/run-component-typecheck.sh --all
./scripts/run-component-tests.sh --all

echo "=== All Quality Checks Passed ==="
\`\`\`

## Hook Execution Order

Pre-commit hooks run in this fixed order; all must pass for
the commit to succeed:

1. File validation (whitespace, EOF, YAML/TOML/JSON syntax)
2. Security scanning (bandit)
3. Global linting (ruff, all files)
4. Global type checking (mypy, all files)
5. Component linting (changed components only)
6. Component type checking (changed components only)
7. Component tests (changed components only)
8. Custom validation (structure, patterns, etc.)

## Best Practices

### For New Projects

Start with strict settings from the beginning: they are
easier to maintain over time. Configure type checking with
`strict = true` in `pyproject.toml`, set up testing early
(include pytest in pre-commit), and document the reason
whenever you must skip a hook.

### For Existing Projects

Use a gradual adoption strategy. Start with global checks
(Layer 1), then add component-specific checks (Layer 2)
once legacy issues are resolved. Use `--no-verify` only for
true emergencies and document why.

### For Monorepos and Plugin Architectures

Standardize per-component Makefiles for `lint`, `typecheck`,
and `test` targets. Centralize common settings in a root
`pyproject.toml` while allowing per-component overrides.
Automate change detection so commits stay fast, and use
progressive disclosure (summary first, detail on failure).

## Related Skills

- `Skill(attune:project-init)`: Full project initialization
- `Skill(attune:workflow-setup)`: GitHub Actions setup
- `Skill(attune:makefile-generation)`: Generate component
  Makefiles
- `Skill(pensive:shell-review)`: Audit shell scripts for
  exit-code and safety issues

## See Also

- **Quality Gates**: three-layer validation: pre-commit
  hooks (formatting, linting), CI checks (tests, coverage),
  and PR review gates (code quality, security).

## Exit Criteria

- [ ] `.pre-commit-config.yaml` exists at the project root with hooks covering at minimum
  Layer 1 (whitespace, YAML/TOML/JSON syntax, global linting).
- [ ] `uv run pre-commit run --all-files` exits 0 after the configuration is installed,
  confirming all hooks pass on the current codebase state.
- [ ] `git commit` with a staged change triggers the pre-commit hooks automatically (verified
  by `uv run pre-commit install` exit code 0 and presence of `.git/hooks/pre-commit`).
- [ ] Any `--no-verify` bypass is absent from the project's documented workflows; if one is
  found in existing scripts, it is flagged as a violation rather than silently accepted.

© athola · MIT · athola/claude-night-market

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

Все скиллы по теме «DevOps и инфраструктура» →
python-code-quality laurigates Скилл python-code-quality для Claude Code и Codex координирует стек проверки качества Python-кода. Включается при вопросах о линтинге, форматировании, стиле и проверке типов через ruff и ty. CX Codex +1 1 100установок shellcheck-configuration Ryan Snodgrass Скилл shellcheck-configuration для Claude Code, Codex и Cursor, который учит агента настраивать ShellCheck и разбирать его предупреждения. Включается, когда в проекте появляется линтинг shell-скриптов или скрипты начинают падать на CI. CX Codex +1 11 533установок tooling-scout Gordon Mickel Субагент tooling-scout сканирует проект на наличие линтеров, форматтеров, type-checker'ов и хуков. Вызывается командой /flow-next:prime, напрямую не запускается. CX Codex ★ 730звёзд репо flake8 sanjeed5 Настраивает flake8 — линтер для проверки стиля Python кода и поиска типичных ошибок. Ловит нарушения PEP 8, баги и считает сложность функций перед коммитом. CX Codex +1 ★ 3 589звёзд репо karpathy-coder claude-code-skills Скилл karpathy-coder для Claude Code проверяет код по четырём принципам Карпати: явные допущения, простота, точечные изменения и проверяемые цели. Запускается при ревью диффа, оценке сложности и подготовке коммита. CX Codex +1 1 053установок setup-formatting davila7 Команда setup-formatting для Claude Code настраивает форматирование кода в проекте под единый стиль. Пригодится при подключении Prettier, Black или rustfmt вместе с git-хуками. CX Codex +1 370установок

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

war-room-checkpoint Скилл war-room-checkpoint считает, насколько дорого откатить решение, и решает, нужен ли полный разбор War Room или хватит быстрой рекомендации. CX Codex +1 2установок shell-review Скилл shell-review аудирует шелл-скрипты на маскировку кодов возврата, переносимость POSIX и безопасность перед коммитом. CX Codex +1 1установок review-chamber Скилл review-chamber сохраняет важные выводы из ревью PR и помогает находить их при дальнейшей работе. Подходит для фиксации архитектурных решений, повторяющихся проблем и стандартов кода. CX Codex +1 1установок delegation-core Скилл delegation-core делегирует задачи восьми внешним CLI (Gemini, Qwen, MiniMax, GLM, Muse, Codex, OpenCode, Glimmer). Оставляет проектирование и архитектуру локально, отправляет исполнение. CX Codex +1 1установок war-room Скилл war-room созывает совет из нескольких LLM для проверки труднообратимых архитектурных решений через оценку обратимости и оппонирование. CX Codex +1 1установок skills-eval Скилл skills-eval для Claude Code проверяет структуру, расход токенов и интеграцию инструментов в других скиллах. Находит проблемы и составляет план исправлений. CX Codex +1 1установок

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

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