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

debug-like-expert — скилл для Claude Code: систематическая отладка

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

MIT ★ 1 988 обновлён 2026-04-01

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Открыть на GitHub

Что делает debug-like-expert

debug-like-expert переводит вас в режим старшего инженера: вместо угадывания причин вы систематически проверяете каждую гипотезу. Скилл начинает с анализа текущего состояния — точного описания ошибки, шагов воспроизведения, ожидаемого результата. Затем трассирует путь выполнения через все компоненты системы, читает релевантный код полностью, собирает информацию о зависимостях и конфигурации.

Критически важный момент: если вы сами писали код, скилл требует большего скепсиса к вашей реализации, чем к чужой. Ваша ментальная модель того, как «должно работать», может ослепить вас к реальному поведению. Скилл помогает преодолеть эту когнитивную ошибку — формирует гипотезы на основе доказательств, а не намерений.

Скилл включает контекстный сканер, который определяет тип проекта (Python, Rust, JavaScript, Swift, Go, Java) и загружает специализированный опыт с известными ошибками и инструментами для конкретного домена. Если домен неочевидный, предлагает выбрать из доступных или работать с общей методикой.

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

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

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

  • Я трачу часы на эту ошибку, стандартные методы не помогают — запусти debug-like-expert
  • Исправления работают, но я не уверен в корневой причине — помогите найти её методично
  • У нас Rust-проект и странное поведение памяти — включи скилл с доменным знанием о системном программировании

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

1Через маркетплейс плагинов

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

Команда ставит плагин taches-cc-resources целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add glittercowboy/taches-cc-resources --skill debug-like-expert -a claude-code

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

~/.claude/skills/debug-like-expert/SKILL.md

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

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

Вопросы о debug-like-expert

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

Выполните по порядку: /plugin marketplace add glittercowboy/taches-cc-resources, затем /plugin install taches-cc-resources@taches-cc-resources. Также можно запустить npx skills add glittercowboy/taches-cc-resources --skill debug-like-expert -a claude-code или открыть ~/.claude/skills/debug-like-expert/SKILL.md.

Зачем нужен debug-like-expert, если я и сам отлаживаю код?

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

Работает ли debug-like-expert с моим языком программирования?

Скилл поддерживает Python, JavaScript, TypeScript, Rust, Swift, Go, C/C++ и Java. При запуске сканирует проект, определяет язык и загружает специализированный опыт — известные ошибки, инструменты и ловушки для этого языка.

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

SKILL.md · MIT
---
name: debug-like-expert
description: Deep analysis debugging mode for complex issues. Activates methodical investigation protocol with evidence gathering, hypothesis testing, and rigorous verification. Use when standard troubleshooting fails or when issues require systematic root cause analysis.
---

<objective>
Deep analysis debugging mode for complex issues. This skill activates methodical investigation protocols with evidence gathering, hypothesis testing, and rigorous verification when standard troubleshooting has failed.

The skill emphasizes treating code you wrote with MORE skepticism than unfamiliar code, as cognitive biases about "how it should work" can blind you to actual implementation errors. Use scientific method to systematically identify root causes rather than applying quick fixes.
</objective>

<context_scan>
**Run on every invocation to detect domain-specific debugging expertise:**

```bash
# What files are we debugging?
echo "FILE_TYPES:"
find . -maxdepth 2 -type f 2>/dev/null | grep -E '\.(py|js|jsx|ts|tsx|rs|swift|c|cpp|go|java)$' | head -10

# Check for domain indicators
[ -f "package.json" ] && echo "DETECTED: JavaScript/Node project"
[ -f "Cargo.toml" ] && echo "DETECTED: Rust project"
[ -f "setup.py" ] || [ -f "pyproject.toml" ] && echo "DETECTED: Python project"
[ -f "*.xcodeproj" ] || [ -f "Package.swift" ] && echo "DETECTED: Swift/macOS project"
[ -f "go.mod" ] && echo "DETECTED: Go project"

# Scan for available domain expertise
echo "EXPERTISE_SKILLS:"
ls ~/.claude/skills/expertise/ 2>/dev/null | head -5
```

**Present findings before starting investigation.**
</context_scan>

<domain_expertise>
**Domain-specific expertise lives in `~/.claude/skills/expertise/`**

Domain skills contain comprehensive knowledge including debugging, testing, performance, and common pitfalls. Before investigation, determine if domain expertise should be loaded.

<scan_domains>
```bash
ls ~/.claude/skills/expertise/ 2>/dev/null
```

This reveals available domain expertise (e.g., macos-apps, iphone-apps, python-games, unity-games).

**If no expertise skills found:** Proceed without domain expertise (graceful degradation). The skill works fine with general debugging methodology.
</scan_domains>

<inference_rules>
If user's description or codebase contains domain keywords, INFER the domain:

| Keywords/Files | Domain Skill |
|----------------|--------------|
| "Python", "game", "pygame", ".py" + game loop | expertise/python-games |
| "React", "Next.js", ".jsx/.tsx" | expertise/nextjs-ecommerce |
| "Rust", "cargo", ".rs" files | expertise/rust-systems |
| "Swift", "macOS", ".swift" + AppKit/SwiftUI | expertise/macos-apps |
| "iOS", "iPhone", ".swift" + UIKit | expertise/iphone-apps |
| "Unity", ".cs" + Unity imports | expertise/unity-games |
| "SuperCollider", ".sc", ".scd" | expertise/supercollider |
| "Agent SDK", "claude-agent" | expertise/with-agent-sdk |

If domain inferred, confirm:
```
Detected: [domain] issue → expertise/[skill-name]
Load this debugging expertise? (Y / see other options / none)
```
</inference_rules>

<no_inference>
If no domain obvious, present options:

```
What type of project are you debugging?

Available domain expertise:
1. macos-apps - macOS Swift (SwiftUI, AppKit, debugging, testing)
2. iphone-apps - iOS Swift (UIKit, debugging, performance)
3. python-games - Python games (Pygame, physics, performance)
4. unity-games - Unity (C#, debugging, optimization)
[... any others found in build/]

N. None - proceed with general debugging methodology
C. Create domain expertise for this domain

Select:
```
</no_inference>

<load_domain>
When domain selected, READ all references from that skill:

```bash
cat ~/.claude/skills/expertise/[domain]/references/*.md 2>/dev/null
```

This loads comprehensive domain knowledge BEFORE investigation:
- Common issues and error patterns
- Domain-specific debugging tools and techniques
- Testing and verification approaches
- Performance profiling and optimization
- Known pitfalls and anti-patterns
- Platform-specific considerations

Announce: "Loaded [domain] expertise. Investigating with domain-specific context."

**If domain skill not found:** Inform user and offer to proceed with general methodology or create the expertise.
</load_domain>

<when_to_load>
Domain expertise should be loaded BEFORE investigation when domain is known.

Domain expertise is NOT needed for:
- Pure logic bugs (domain-agnostic)
- Generic algorithm issues
- When user explicitly says "skip domain context"
</when_to_load>
</domain_expertise>

<context>
This skill activates when standard troubleshooting has failed. The issue requires methodical investigation, not quick fixes. You are entering the mindset of a senior engineer who debugs with scientific rigor.

**Important**: If you wrote or modified any of the code being debugged, you have cognitive biases about how it works. Your mental model of "how it should work" may be wrong. Treat code you wrote with MORE skepticism than unfamiliar code - you're blind to your own assumptions.
</context>

<core_principle>
**VERIFY, DON'T ASSUME.** Every hypothesis must be tested. Every "fix" must be validated. No solutions without evidence.

**ESPECIALLY**: Code you designed or implemented is guilty until proven innocent. Your intent doesn't matter - only the code's actual behavior matters. Question your own design decisions as rigorously as you'd question anyone else's.
</core_principle>

<quick_start>

<evidence_gathering>

Before proposing any solution:

**A. Document Current State**
- What is the EXACT error message or unexpected behavior?
- What are the EXACT steps to reproduce?
- What is the ACTUAL output vs EXPECTED output?
- When did this start working incorrectly (if known)?

**B. Map the System**
- Trace the execution path from entry point to failure point
- Identify all components involved
- Read relevant source files completely, not just scanning
- Note dependencies, imports, configurations affecting this area

**C. Gather External Knowledge (when needed)**
- Use MCP servers for API documentation, library details, or domain knowledge
- Use web search for error messages, framework-specific behaviors, or recent changes
- Check official docs for intended behavior vs what you observe
- Look for known issues, breaking changes, or version-specific quirks

See [references/when-to-research.md](references/when-to-research.md) for detailed guidance on research strategy.

</evidence_gathering>

<root_cause_analysis>

**A. Form Hypotheses**

Based on evidence, list possible causes:
1. [Hypothesis 1] - because [specific evidence]
2. [Hypothesis 2] - because [specific evidence]
3. [Hypothesis 3] - because [specific evidence]

**B. Test Each Hypothesis**

For each hypothesis:
- What would prove this true?
- What would prove this false?
- Design a minimal test
- Execute and document results

See [references/hypothesis-testing.md](references/hypothesis-testing.md) for scientific method application.

**C. Eliminate or Confirm**

Don't move forward until you can answer:
- Which hypothesis is supported by evidence?
- What evidence contradicts other hypotheses?
- What additional information is needed?

</root_cause_analysis>

<solution_development>

**Only after confirming root cause:**

**A. Design Solution**
- What is the MINIMAL change that addresses the root cause?
- What are potential side effects?
- What could this break?

**B. Implement with Verification**
- Make the change
- Add logging/debugging output if needed to verify behavior
- Document why this change addresses the root cause

**C. Test Thoroughly**
- Does the original issue still occur?
- Do the reproduction steps now work?
- Run relevant tests if they exist
- Check for regressions in related functionality

See [references/verification-patterns.md](references/verification-patterns.md) for comprehensive verification approaches.

</solution_development>

</quick_start>

<critical_rules>

1. **NO DRIVE-BY FIXES**: If you can't explain WHY a change works, don't make it
2. **VERIFY EVERYTHING**: Test your assumptions. Read the actual code. Check the actual behavior
3. **USE ALL TOOLS**:
   - MCP servers for external knowledge
   - Web search for error messages, docs, known issues
   - Extended thinking ("think deeply") for complex reasoning
   - File reading for complete context
4. **THINK OUT LOUD**: Document your reasoning at each step
5. **ONE VARIABLE**: Change one thing at a time, verify, then proceed
6. **COMPLETE READS**: Don't skim code. Read entire relevant files
7. **CHASE DEPENDENCIES**: If the issue involves libraries, configs, or external systems, investigate those too
8. **QUESTION PREVIOUS WORK**: Maybe the earlier "fix" was wrong. Re-examine with fresh eyes

</critical_rules>

<success_criteria>

Before starting:
- [ ] Context scan executed to detect domain
- [ ] Domain expertise loaded if available and relevant

During investigation:
- [ ] Do you understand WHY the issue occurred?
- [ ] Have you verified the fix actually works?
- [ ] Have you tested the original reproduction steps?
- [ ] Have you checked for side effects?
- [ ] Can you explain the solution to someone else?
- [ ] Would this fix survive code review?

If you can't answer "yes" to all of these, keep investigating.

**CRITICAL**: Do NOT mark debugging tasks as complete until this checklist passes.

</success_criteria>

<output_format>

```markdown
## Issue: [Problem Description]

### Evidence
[What you observed - exact errors, behaviors, outputs]

### Investigation
[What you checked, what you found, what you ruled out]

### Root Cause
[The actual underlying problem with evidence]

### Solution
[What you changed and WHY it addresses the root cause]

### Verification
[How you confirmed this works and doesn't break anything else]
```

</output_format>

<advanced_topics>

For deeper topics, see reference files:

**Debugging mindset**: [references/debugging-mindset.md](references/debugging-mindset.md)
- First principles thinking applied to debugging
- Cognitive biases that lead to bad fixes
- The discipline of systematic investigation
- When to stop and restart with fresh assumptions

**Investigation techniques**: [references/investigation-techniques.md](references/investigation-techniques.md)
- Binary search / divide and conquer
- Rubber duck debugging
- Minimal reproduction
- Working backwards from desired state
- Adding observability before changing code

**Hypothesis testing**: [references/hypothesis-testing.md](references/hypothesis-testing.md)
- Forming falsifiable hypotheses
- Designing experiments that prove/disprove
- What makes evidence strong vs weak
- Recovering from wrong hypotheses gracefully

**Verification patterns**: [references/verification-patterns.md](references/verification-patterns.md)
- Definition of "verified" (not just "it ran")
- Testing reproduction steps
- Regression testing adjacent functionality
- When to write tests before fixing

**Research strategy**: [references/when-to-research.md](references/when-to-research.md)
- Signals that you need external knowledge
- What to search for vs what to reason about
- Balancing research time vs experimentation

</advanced_topics>

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

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

Все скиллы по теме «Код-ревью и рефакторинг» →
principle-attack-the-premise backnotprop Скилл principle-attack-the-premise для Claude Code разбирает общую предпосылку после провала двух исправлений на одном этапе проверки. Он предлагает проверить её до следующей попытки. CX Codex +1 10 100установок gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок debug Rudolf S. Скилл debug для Claude Code пошагово расследует ошибки: проверяет воспроизводимость, ведёт реестр гипотез и подтверждает первопричину. CX Codex +1 ★ 587звёзд репо debugging mrgoonie Скилл debugging систематизирует отладку кода: запрещает править наугад без поиска первопричины и требует проверять результат тестами перед закрытием задачи. CX Codex +1 580установок error-diagnostics-smart-debug sickn33 Скилл error-diagnostics-smart-debug разбирает сбои по шагам воспроизведения, трассировкам, логам и коду, затем помогает проверить гипотезу и зафиксировать исправление. CX Codex +1 1установок 08-debug AI-Driven Dev Скилл 08-debug для разбора багов: воспроизводит известную ошибку вместе с тестом и правкой, а неясную причину ищет перебором гипотез. CX Codex +1 ★ 571звёзд репо

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

Весь набор →
slash-command-auditor Субагент slash-command-auditor аудирует .md-файлы слэш-команд Claude Code по структуре, аргументам, контексту, инструментам и безопасности. CX Codex ★ 1 988звёзд репо create-hooks Скилл create-hooks учит писать и настраивать хуки Claude Code: от блокировки опасных команд до автоформатирования после правок. CX Codex +1 ★ 1 988звёзд репо subagent-auditor Субагент subagent-auditor проверяет конфигурационные файлы субагентов Claude Code на соответствие лучшим практикам. Находит ошибки в структуре XML, лишние права инструментов и слабые описания ролей. CX Codex ★ 1 988звёзд репо create-subagents Скилл create-subagents для Claude Code объясняет, как создавать субагентов, настраивать их инструменты и поручать им задачи через Task. Разделяет работу между агентами. CX Codex +1 ★ 1 988звёзд репо skill-auditor Субагент skill-auditor проверяет файлы SKILL.md на соответствие стандартам Claude Code: валидирует чистую XML-разметку, длину описаний и структуру ссылок. CX Codex ★ 1 988звёзд репо create-slash-commands Скилл create-slash-commands для Claude Code — учит писать слэш-команды с YAML frontmatter и XML-тегами. Стандартизирует повторяющиеся операции. CX Codex +1 ★ 1 988звёзд репо create-prompt Команда create-prompt для создания готовых промптов, которые другой Claude сможет выполнить. Помогает структурировать задачу и сразу сохранить её в проект. CX Codex +1 ★ 1 988звёзд репо create-plans Скилл create-plans генерирует атомарные планы разработки для связки соло-разработчика и Claude Code. Делит задачи на микроэтапы с критериями проверки. CX Codex +1 ★ 1 988звёзд репо

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

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