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

debug · pwguler — скилл для Claude Code: что делает и как установить

Скилл debug для Claude Code и Cursor находит корень ошибки по шагам и проверяет тест до правок.

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

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

Что делает debug

Агент выстраивает список задач для поиска причины ошибки, строит минимальное воспроизведение и проверяет гипотезы. Лишний мертвый код удаляется из изменяемых файлов перед правкой. После исправления агент добавляет регрессионный тест и запускает проверку.

Процесс останавливается после трех неверных гипотез подряд или при отсутствии воспроизведения ошибки. Правило запускается по словам вроде ошибки или сбоя в работе кода.

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

  • найти корень ошибки по шагам
  • собрать минимальное воспроизведение сбоя
  • добавить регрессионный тест для исправления
  • удалить мертвый код перед правкой

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

  • Исправь баг в модуле авторизации
  • Тест падает с ошибкой, разберись
  • Код сломался после обновления зависимостей

Как установить debug

1Через Skills CLI (Vercel)

npx skills add pwguler/skills --skill debug -a claude-code

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

~/.claude/skills/debug/SKILL.md

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

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

Вопросы о debug

Как установить debug в Claude Code?

Выполните команды npx skills add pwguler/skills --skill debug -a claude-code и ~/.claude/skills/debug/SKILL.md.

Что делает debug?

Находит первопричину сбоя, строит тест воспроизведения, проверяет гипотезы и добавляет регрессионный тест после исправления.

Когда активируется скилл?

Агент подключает скилл при упоминании ошибки, сбоя, поломки или при неожиданном падении теста в работе.

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

SKILL.md · MIT
---
name: debug
description: Find the root cause of a bug before you fix it. Read this skill before you fix any bug. Read it also when the fix looks obvious. Use it when the user says "fix", "broken", "not working", "error", "failing", or "bug". Use it also when a test fails unexpectedly during other work.
---

Do not fix a bug before you know its root cause. The search starts at the symptom, but it does not end there.

Fast path: when the error output shows the first cause directly, skip the hypothesis steps. An example is a stack line that points at the cause. Do not skip the reproduction, the regression test, or the `verify` skill in step 8. If the visible fix does not make the reproduction pass on the first try, the cause was not visible. Then do all the steps.

1. Before you reproduce the bug, create a task list with these steps as its items. If a task list already exists, add the steps to it. Each step is one item. When you skip a step, mark it done and add `skip: <reason>` to its text. The fast path skips the hypothesis steps this way. To go back to an earlier step, add that step and each step after it again as new items. Then delete the unfinished items that the new items replace.
2. Reproduce the bug first. Build the smallest reproduction that fails every time. If you cannot reproduce the bug, collect evidence until you can: logs, inputs, and versions. Do not guess.
3. Read the actual error. Find the first cause in the chain of causes, not the nearest symptom.
4. Make one hypothesis. Write it with the observation that would confirm it or refute it. Get that observation before you start a fix: a log line, an assertion, or a probe. If the evidence does not exist yet, add instrumentation. Keep the instrumentation small and easy to remove, and remove it when it has given its answer.
5. When two hypotheses compete, design one observation that shows which one is true. Do not try fixes one after another.
6. Fix the root cause, one fix at a time. Flag another problem that you find, such as a second bug, but do not fix it. Dead code is not another problem. Before the fix, delete the dead code in each file that the fix changes, as `implement` does. Do this also when the bug did not touch that code. Dead code is functions, imports, and parameters that no caller uses, and branches that no caller reaches. It is also stale flags, and validators that repeat a check that a boundary already did. It is also comments that repeat the code or excuse a workaround. Keep dead code that a non-goal puts out of scope. Read [fix root causes](references/fix-root-causes.md) before a fix that adds a guard, a catch, or a comment that defends it. Read it also when the same cause can occur elsewhere, or when the failure shows only after a restart.
7. Add the regression test that would have caught this bug. It fails on the old code and passes with the fix.
8. Before you report the fix, read the `verify` skill and follow it. Your report claims that the bug is fixed, and `verify` proves that claim. When the bug appeared inside a slice, the full gate waits for the slice's commit.

Rules:

- Do not try several fixes at random to see if one helps.
- Stop the loop after three refuted hypotheses in a row. Stop it also when the available evidence cannot give a reproduction. Then report what you tried and which observation is missing, and let the user decide.
- If the fix does not make the reproduction pass, the hypothesis was wrong. Go back to step 4. Do not keep the failed fix and add a second fix. When two failed fixes shared one premise, read [attack the premise](references/attack-the-premise.md).
- If the root cause shows a design problem, say so. Offer to run `drill` on the redesign. Do not hide the problem under a workaround.
- When the cause took more than one hypothesis to find, propose a cheap signal that stays on. It is a log line, a metric, or an assertion that would have shown this cause at once. Add it when the user agrees.

© pwguler · MIT · pwguler/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

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

debug официальный anthropics Скилл debug для Claude Code помогает воспроизвести ошибку, найти её причину и подготовить исправление. Запускается по сообщению об ошибке, трассировке стека или описанию неожиданного поведения. CX Codex +1 6 100установок debug jsmastery-pro Скилл debug запускает цикл поиска первопричины бага: воспроизводит сбой, изолирует место ошибки, проверяет гипотезы и готовит минимальное исправление. CX Codex +1 5 100установок debug Yeachan-Heo Скилл debug находит причины сбоев в текущей сессии Claude Code или кодовой базе через анализ логов, трейсов и состояния агента. Пригодится при поломке хуков или сценариев. CX Codex +1 705установок debug cyrusagents Скилл debug для Claude Code разбирает баг от воспроизведения до минимального исправления. Он находит причину ошибки и проверяет результат. CX Codex +1 871установок debug parcadei Скилл debug для Claude Code исследует ошибки по логам, состоянию базы данных и истории Git. Запускается, когда проблема возникает при ручном тестировании или разработке. CX Codex +1 511установок ce-debug EveryInc Скилл ce-debug для Claude Code находит причину ошибки или медленной работы. Запускается по просьбе разобраться со сбоем или исправить его. CX Codex +1 3 700установок debug-systematic travisjneuman Скилл debug-systematic для Claude Code ведёт агента через четыре фазы отладки: воспроизведение, локализацию, поиск причины и проверку исправления. Разбирает сложные и плавающие ошибки. CX Codex +1 152установок doca-debug NVIDIA Скилл doca-debug для Claude Code разбирает сбои DOCA по слоям: установка, сборка, линковка, запуск и драйвер. Разбирает ошибки символов, DOCAERROR и пустой вывод инструментов. CX Codex +1 162установок sleuth parcadei Субагент sleuth для системного разбора ошибок: ищет корень проблемы через код, логи и историю изменений, документирует гипотезы и выводы. CX Codex ★ 3 951звёзд репо gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок debug-mantra thananon Скилл debug-mantra для Claude Code задаёт порядок отладки: воспроизвести сбой, найти путь ошибки, проверить гипотезы и сверить результаты. Запускается по /debug-mantra и при сообщениях об ошибках или поломках. CX Codex +1 5 100установок

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

Весь набор →
write-skill write-skill — скилл для Claude Code, который создаёт и правит текстовые файлы для агентов с проверкой поведения. Запускается при создании системных промптов, файлов CLAUDE.md и AGENTS.md, а также при повторных исправлениях ошибок агента. CX Codex +1 1 000установок parallel Скилл parallel для Claude Code запускает независимые задачи в субагентах параллельно. Он включается только по просьбе распараллелить работу, сравнить попытки или охватить части одной задачи. CX Codex +1 1 000установок core-interview Скилл core-interview для Claude Code проводит опрос по дереву решений для сбора требований, пока не будут согласованы все детали. CX Codex +1 1 000установок research Скилл research для Claude Code исследует поведение библиотек и причины устройства кода. Агент обращается к нему, когда нужно проверить API или объяснить константу, настройку либо решение в коде. CX Codex +1 1 000установок verify Скилл verify для Claude Code проверяет заявления о готовности по свежему выводу команд. Он включается перед коммитом или PR, после изменений и перед сообщением, что работа завершена или исправлена. CX Codex +1 1 000установок land Скилл land для Claude Code завершает ветку разработки через слияние, открытие пулл-реквеста, сохранение или удаление. Включается в работу после завершения реализации задачи. CX Codex +1 1 000установок drill Помогает разобрать план или дизайн до согласования решений. Запускается при запросе новой функции, спорном дизайне или просьбе «drill this». CX Codex +1 1 000установок implement Реализует готовый план небольшими срезами через TDD. Включается по запросу написать код по спецификации или фразе «implement this». CX Codex +1 1 000установок

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

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