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

linter-docs — скилл для Claude Code: справочник по линтерам

Справочник по правилам ESLint, Ruff, Pylint, RuboCop, Stylelint и Clippy. Нужен, когда пишешь или отлаживаешь правило enforce() в vigiles.

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

Что делает linter-docs

Скилл открывает файл с деталями по конкретному линтеру: точные имена правил, AST-селекторы, конфигурация, автофиксы. Внутри шесть файлов — eslint.md, ruff.md, pylint.md, rubocop.md, stylelint.md, clippy.md. Для ESLint это таблица плагинов и правила с учётом типов, для Ruff — больше 800 переписанных правил и настройка в pyproject, для Pylint — таблица плагинов и astroid AST, для RuboCop — таблица гемов и DSL node pattern, для Stylelint — PostCSS AST и SCSS, для Clippy — группы линтов и конфигурация.

Это справочник, а не действие. Скилл не запускается сам: в нём стоит disable-model-invocation: true, поэтому файл открываешь вручную, когда нужен точный идентификатор правила или разбор, почему правило помечено как отсутствующее либо отключённое. Его читают скиллы strengthen и edit-spec, когда сопоставляют правило из инструкции с реальным правилом линтера.

Линтеры для JVM и Go — detekt, ktlint, Checkstyle, golangci-lint — вместе с Cedar тоже упоминаются в enforce(), но глубокого разбора по ним здесь нет. Их возможности и ограничения лежат в docs/linter-support.md. Учти: ktlint работает только с форматированием, а у Checkstyle состояние включения задаётся белым списком. Если пишешь правило под Go или JVM, этот скилл не поможет — иди сразу в docs/linter-support.md.

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

  • найти точное имя правила ESLint для своего случая
  • понять, почему правило vigiles помечено как отключённое
  • настроить выбор правил Ruff в pyproject
  • разобраться с node pattern DSL в RuboCop
  • сопоставить правило из инструкции с реальным правилом линтера

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

  • Открой eslint.md и найди правило для запрета any в аргументах функций
  • Мне нужно написать enforce() для Ruff — покажи, как выбираются правила в pyproject
  • Почему vigiles считает правило Pylint отсутствующим? Посмотри pylint.md

Как установить linter-docs

1Через Skills CLI (Vercel)

npx skills add zernie/vigiles --skill linter-docs -a claude-code

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

~/.claude/skills/linter-docs/SKILL.md

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

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

Вопросы о linter-docs

Как установить linter-docs в Claude?

Выполни npx skills add zernie/vigiles --skill linter-docs -a claude-code. После этого файл скилла окажется в ~/.claude/skills/linter-docs/SKILL.md.

Что делает linter-docs?

Даёт справку по правилам шести линтеров: имена, AST-селекторы, конфигурацию, автофиксы. Помогает писать и отлаживать правила enforce() в vigiles.

Скилл запускается сам?

Нет. В нём стоит disable-model-invocation: true, так что он работает как справочник: открываешь нужный файл вручную.

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

SKILL.md · MIT
---
name: linter-docs
description: Deep linter reference for authoring or debugging a vigiles enforce() rule — plugin tables, AST selectors, type-aware rules, auto-fix, and edge cases for ESLint, Ruff, Pylint, RuboCop, Stylelint, and Clippy. Use when you need the exact rule name or config for a specific linter, not for running a linter. (JVM/Go linters — detekt, ktlint, Checkstyle, golangci-lint — and Cedar have no deep-dive file yet; their reference lives in docs/linter-support.md.)
disable-model-invocation: true
---

Reference material for the linters vigiles cross-references. Open the file for
the linter you're working with when you need exact rule names, AST selectors,
or config details to author an `enforce()` rule (or diagnose why one is reported
missing or disabled).

| Linter    | Reference                                                                              |
| --------- | -------------------------------------------------------------------------------------- |
| ESLint    | [`eslint.md`](eslint.md) — plugin table, AST selectors, type-aware rules, auto-fix     |
| Ruff      | [`ruff.md`](ruff.md) — 800+ reimplemented rules, selection, auto-fix, pyproject config |
| Pylint    | [`pylint.md`](pylint.md) — plugin table, astroid AST, type inference, custom checkers  |
| RuboCop   | [`rubocop.md`](rubocop.md) — gem table, node pattern DSL, auto-correct, custom cops    |
| Stylelint | [`stylelint.md`](stylelint.md) — plugin table, PostCSS AST, custom rules, SCSS         |
| Clippy    | [`clippy.md`](clippy.md) — Rust lint groups and configuration                          |

**JVM/Go linters (detekt, ktlint, Checkstyle, golangci-lint) and Cedar** are
cross-referenced by `enforce()` but have no deep-dive file here yet — their
capabilities, config surfaces, and known limits (e.g. ktlint is format-only,
Checkstyle enabled-state is whitelist-only) are documented in
[`docs/linter-support.md`](../../docs/linter-support.md).

These are read by the `strengthen` and `edit-spec` skills when matching a
guidance rule to a real linter rule. This skill is user-invoked (a reference,
not an action), so it never fires on its own — open the relevant file directly.

© zernie · MIT · zernie/vigiles

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

Всё по теме «Код-ревью и рефакторинг» →
lint-on-save davila7 Хук запускает линтер сразу после того, как агент изменил файл. ESLint, Pylint и RuboCop срабатывают сами, без ручного вызова. 3 235установок typescript-docs giuseppe-trisciuoglio Создаёт документацию TypeScript с JSDoc, TypeDoc и ADR. Пригодится для описания API, решений по архитектуре и кода на популярных фреймворках. CX Codex +1 4 200установок rust-best-practices apollographql Скилл для написания и ревью Rust-кода по хендбуку Apollo GraphQL: заимствование против клонирования, обработка ошибок, тесты. CX Codex +1 21 100установок coding-guidelines actionbook Скилл с 50 правилами оформления кода на Rust: имена, строки, ошибки, память, async. Пригодится на ревью и когда агент пишет новый модуль. CX Codex +1 4 000установок ruff astral-sh Скилл объясняет агенту, как запускать ruff для проверки и форматирования Python-кода, и когда трогать файлы не стоит. CX Codex +1 3 400установок python-code-style Seth Hobson Скилл задаёт правила стиля Python, настройки линтеров, форматирования и документации. Пригодится для новых модулей, ревью и настройки проекта. CX Codex 16 456установок

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

test-harness Скилл помогает протестировать обвязку Claude: хуки, скиллы, агентов, настройки и CLAUDE.md. Выбирает подходящий уровень теста и пишет его. CX Codex +1 2 100установок strengthen Скилл проходит по спекам vigiles и переводит правила guidance() в enforce(), подбирая под них реальные правила линтеров. Пригодится, когда хочется, чтобы договорённости проверялись автоматически. CX Codex +1 2 100установок adopt-spec Превращает уже написанный CLAUDE.md или AGENTS.md в типизированный CLAUDE.md.spec.ts, не трогая исходный файл. Пригодится, если хочется проверять инструкции линтером, но переписывать их с нуля неохота. CX Codex +1 1 800установок debug-my-harness Разбирает, почему агентная обвязка сработала не так, читая локальный журнал .vigiles/runs.jsonl. Пригодится, когда скилл перестал запускаться или хук пропустил то, что должен был заблокировать. CX Codex +1 1 500установок code-quality Скилл для рефакторинга TypeScript и JavaScript: приводит типы в порядок, убирает невозможные состояния и разделяет логику с вводом-выводом. CX Codex +1 391установок verify-docs-findable Проверяет, отвечает ли документация на реальные вопросы читателя. Запускает дешёвых агентов Haiku, которые читают только доки и показывают, где ответы теряются. CX Codex +1 340установок

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

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