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

llm-artifacts-detection — скилл для Claude Code: как установить

Скилл llm-artifacts-detection находит типичный мусор после ИИ-кодеров: лишние слои абстракций, тесты стандартных библиотек, мёртвый код и очевидные комментарии.

Apache-2.0 151 установок ★ 89 обновлён 2026-09-15

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

Что делает llm-artifacts-detection

Скилл проверяет кодовую базу на дефекты, которые часто оставляют языковые модели. Он делит проверку на четыре направления: тесты, мёртвый код, избыточные абстракции и многословный стиль. Если среда поддерживает субагентов, проверки запускаются параллельно. В противном случае анализ идёт последовательно.

В тестах отслеживаются дублирование настроек и проверки поведения стандартной библиотеки вместо логики проекта. В архитектуре скилл выявляет пустые классы-обёртки и интерфейсы с единственной реализацией. В секции стиля отлавливаются комментарии вроде # return the result и лишние проверки на null там, где система типов гарантирует значение.

Все находки выводятся строго в формате [FILE:LINE] ISSUE_TITLE. Номер строки и имя файла берутся только из прочитанного буфера файла, а не из поисковой выдачи или памяти модели.

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

  • найти в коде неиспользуемые классы, функции и забытые комментарии TODO
  • выявить тесты, проверяющие сторонние библиотеки вместо логики приложения
  • обнаружить избыточные классы-обёртки и интерфейсы с одной реализацией
  • убрать очевидные комментарии и лишние защитные блоки try/except

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

  • Проверь проект на следы генерации ИИ и выведи найденные артефакты в формате [FILE:LINE]
  • Запусти аудит тестов на дублирование фикстур и проверку стандартной библиотеки
  • Найди в кодовой базе мёртвый код, устаревшие флаги совместимости и брошенные TODO

Как установить llm-artifacts-detection

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill llm-artifacts-detection -a claude-code

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

~/.claude/skills/llm-artifacts-detection/SKILL.md

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

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

Вопросы о llm-artifacts-detection

Как установить llm-artifacts-detection в Claude Code?

Выполните в терминале команду npx skills add existential-birds/beagle --skill llm-artifacts-detection -a claude-code. Конфигурационный файл сохранится по пути ~/.claude/skills/llm-artifacts-detection/SKILL.md.

Что делает скилл llm-artifacts-detection?

Он проверяет репозиторий на артефакты генерации кода: лишние слои абстракций, дублирование моков, мёртвые ветки и паразитные комментарии.

Как скилл защищает от выдуманных номеров строк?

Правило Anchor требует привязывать каждый дефект к координатам из вызова read_file или открытого буфера. Выводить строки из старых сниппетов поиска запрещено.

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

SKILL.md · Apache-2.0
---
name: llm-artifacts-detection
description: Detects common LLM coding agent artifacts in codebases. Identifies test quality issues, dead code, over-abstraction, and verbose LLM style patterns. Use when cleaning up AI-generated code or reviewing for agent-introduced cruft.
user-invocable: false
---

# LLM Artifacts Detection

Detect and flag common patterns introduced by LLM coding agents that reduce code quality.

## Detection Categories

| Category | Reference | Key Issues |
|----------|-----------|------------|
| Tests | [references/tests-criteria.md](references/tests-criteria.md) | DRY violations, library testing, mock boundaries |
| Dead Code | [references/dead-code-criteria.md](references/dead-code-criteria.md) | Unused code, TODO/FIXME, backwards compat cruft |
| Abstraction | [references/abstraction-criteria.md](references/abstraction-criteria.md) | Over-abstraction, copy-paste drift, over-configuration |
| Style | [references/style-criteria.md](references/style-criteria.md) | Obvious comments, defensive overkill, unnecessary types |

## Agent Prompts

Use these prompts to spawn focused detection agents:

### Tests Agent

```
Analyze the test files for LLM-introduced test quality issues:

1. **DRY Violations**: Look for setup/teardown code repeated across multiple test functions instead of using fixtures or shared helpers. Flag patterns like:
   - Identical object creation in multiple tests
   - Repeated mock configurations
   - Copy-pasted database setup

2. **Library Testing**: Identify tests that validate standard library or framework behavior rather than application code. Signs:
   - No imports from the application codebase
   - Testing built-in functions or third-party library methods
   - Assertions about stdlib behavior

3. **Mock Boundaries**: Flag mocking that's too deep or too shallow:
   - Too deep: Mocking internal implementation details, private methods
   - Too shallow: Mocking at the wrong layer, missing integration points
   - Wrong level: Unit test mocks in integration tests or vice versa

For each issue found, report: [FILE:LINE] ISSUE_TITLE
```

### Dead Code Agent

```
Scan the codebase for dead code and cleanup opportunities:

1. **Unused Code**: Find functions, classes, and variables with no references:
   - Functions never called
   - Classes never instantiated
   - Module-level variables never read
   - Unreachable code after returns

2. **TODO/FIXME Comments**: Flag all TODO, FIXME, HACK, XXX comments that indicate incomplete work

3. **Backwards Compat Cruft**: Look for patterns suggesting removed features:
   - Variables renamed with _unused, _old, _deprecated suffixes
   - Re-exports only for backwards compatibility
   - Comments like "# removed", "# legacy", "# deprecated"
   - Empty functions/classes kept "for compatibility"

4. **Orphaned Tests**: Tests for code that no longer exists:
   - Test files with no corresponding source
   - Test functions testing deleted features

For each issue found, report: [FILE:LINE] ISSUE_TITLE
```

### Abstraction Agent

```
Review the codebase for over-engineering introduced by LLM agents:

1. **Over-Abstraction**: Identify unnecessary abstraction layers:
   - Wrapper classes that just delegate to one method
   - Interfaces/protocols with only one implementation
   - Abstract base classes with single concrete class
   - Factory functions that always return the same type

2. **Copy-Paste Drift**: Find 3+ similar code blocks that should be parameterized:
   - Nearly identical functions with minor variations
   - Repeated patterns that could be a single function with parameters
   - Similar class methods across multiple classes

3. **Over-Configuration**: Flag configuration for non-configurable things:
   - Feature flags that are never toggled
   - Environment variables always set to one value
   - Config options with no production variation
   - Overly generic code for single use case

For each issue found, report: [FILE:LINE] ISSUE_TITLE
```

### Style Agent

```
Check for verbose LLM-style patterns that reduce code clarity:

1. **Obvious Comments**: Comments that restate what the code clearly does:
   - "# increment counter" above counter += 1
   - "# return the result" above return result
   - Docstrings that repeat the function name

2. **Over-Documentation**: Excessive documentation on trivial code:
   - Full docstrings on simple getters/setters
   - Parameter descriptions for obvious args
   - Return value docs for self-evident returns

3. **Defensive Overkill**: Unnecessary defensive programming:
   - try/except around code that cannot fail
   - Null checks on values that can't be null
   - Type checks after type hints guarantee the type
   - Validation of already-validated inputs

4. **Unnecessary Type Hints**: Type hints that add no value:
   - Type hints on obvious literal assignments
   - Redundant hints on variables immediately clear from context
   - Over-annotated internal/local variables

For each issue found, report: [FILE:LINE] ISSUE_TITLE
```

## Gates (reporting)

Run these in order so findings are evidence-bound, not inferred. This is the detection-side instance of the **Anti-confabulation gate** in the [review-verification-protocol](../review-verification-protocol/SKILL.md) skill: every `[FILE:LINE]` must be echoed from a freshly read buffer in this turn, never inferred from the branch name, directory, or memory.

1. **Anchor** — Set `FILE` and `LINE` from an opened buffer, `read_file`, or equivalent; do not rely only on stale search snippets. **Pass:** `LINE` is in range for `FILE`, and the described issue is visible on that line or its immediate neighbors.
2. **Title** — `ISSUE_TITLE` states the defect in plain language (about one short sentence), not a proposed fix. **Pass:** someone opening `FILE` at `LINE` can see why the title applies.
3. **Dedup** — Before final output, merge rows that share the same `FILE:LINE` and root cause. **Pass:** at most one `[FILE:LINE] ISSUE_TITLE` per distinct defect at that anchor.

## Usage

1. Load this skill when reviewing AI-generated code
2. **If the agent supports subagents**, dispatch one per detection category in parallel; **otherwise** work through the categories sequentially yourself, producing the same `[FILE:LINE] ISSUE_TITLE` findings.
3. Use reference files for detailed criteria and examples
4. Apply **Gates (reporting)** above, then emit findings as `[FILE:LINE] ISSUE_TITLE`

## When to Apply

- Cleaning up code written by AI coding agents
- Post-generation code review
- Reducing code bloat from iterative AI generation
- Identifying patterns that reduce maintainability

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Код-ревью и рефакторинг» →
simplify SeifBenayed Скилл simplify для Claude Code, Codex и Cursor проходит по коду и убирает лишнюю сложность. Запускается на свежих правках или на отдельном файле, который разросся. CX Codex +1 ★ 116звёзд репо clean-code alirezarezvani Промпт clean-code для Claude Code помогает проверять код, проводить ревью и рефакторинг, улучшать читаемость. Включается для разбора функций, модулей и соглашений об именах. GP ChatGPT ★ 788звёзд репо base alinaqi Скилл base задаёт правила чистого кода, лимиты на размер файлов и строгий TDD-процесс для ИИ-агентов. CX Codex +1 276установок typescript-clean-code bmad-labs Скилл typescript-clean-code для ревью и рефакторинга TypeScript: каталоги запахов кода, четыре слоя проверки и готовые рабочие процессы. CX Codex +1 669установок refactor-clean sangrokjung Команда refactor-clean ищет мёртвый код, предлагает безопасное удаление и проверяет тесты до и после каждого изменения. CX Codex +1 ★ 880звёзд репо test-smell-detection dotnet Скилл test-smell-detection для Claude Code проверяет тесты по таксономии testsmells.org и ранжирует найденные дефекты по риску. Разбирает архитектурные проблемы тестовой базы. CX Codex +1 4 400установок

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

Весь набор →
pydantic-ai-tool-system Скилл pydantic-ai-tool-system помогает агенту корректно объявлять инструменты PydanticAI с нужными декораторами, докстрингами и типами контекста. CX Codex +1 161установок langgraph-implementation Скилл langgraph-implementation помогает собирать состояния графов LangGraph, задавать узлы и переходы, добавлять сохранение и паузы для участия человека. CX Codex +1 161установок postgres-code-review Скилл postgres-code-review проверяет SQL, схемы и код работы с PostgreSQL: ищет проблемы с индексами, JSONB, соединениями и транзакциями. Подключайте его при ревью изменений в базе. CX Codex +1 158установок explanation-docs Скилл explanation-docs для Claude Code помогает писать документы о том, как и почему устроена система. Документирует архитектурные решения и материалы для онбординга. CX Codex +1 152установок go-testing-code-review Скилл go-testing-code-review ревьюит тесты Go: табличные кейсы, сообщения об ошибках, параллельность и покрытие. Замечания отдаёт с файлом, строкой и важностью. CX Codex +1 148установок pydantic-ai-testing Скилл pydantic-ai-testing помогает писать тесты для агентов PydanticAI: подменять ответы модели, проверять вызовы инструментов и воспроизводить записанные API-запросы. CX Codex +1 146установок adr-decision-extraction Скилл adr-decision-extraction извлекает архитектурные решения из чатов и расшифровок, чтобы подготовить материал для ADR. Он распознаёт выбор технологий, компромиссы и явные метки. CX Codex +1 144установок deepagents-implementation Скилл deepagents-implementation для Claude Code даёт рецепты сборки агентов на Deep Agents: фабрика create_deep_agent, файловые бэкенды, субагенты и стриминг LangGraph. CX Codex +1 142установок

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

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