Debug
Comprehensive debugging methodology for finding and fixing bugs (formerly debugging). This skill should be used when debugging code, investigating errors, troubleshooting issues, performing root cause analysis, or responding to incidents. Covers systematic reproduction, hypothesis-driven investigation, and root cause analysis techniques. Use when encountering exceptions, stack traces, crashes, segfaults, undefined behavior, or when bug reports need investigation.
Install
npx skills add pproenca/dot-skills --skill debuggit clone --depth 1 https://github.com/pproenca/dot-skills.git /tmp/dot-skills
mkdir -p ~/.claude/skills
cp -r /tmp/dot-skills/skills/.curated/debug ~/.claude/skills/debugPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# dot-skills Debugging Best Practices Comprehensive debugging methodology guide for software engineers, containing 54 rules across 10 categories prioritized by impact. Based on research from Andreas Zeller's "Why Programs Fail" and academic debugging curricula. ## When to Apply Reference these guidelines when: - Investigating a bug or unexpected behavior - Debugging code during development - Code produces wrong results or crashes - Performance issues need root cause analysis - Triaging incoming bug reports and prioritizing fixes - Conducting root cause analysis for incidents - Reviewing debugging approaches or code for common bug patterns ## Rule Categories by Priority | Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Problem Definition | CRITICAL | `prob-` | | 2 | Hypothesis-Driven Search | CRITICAL | `hypo-` | | 3 | Observation Techniques | HIGH | `obs-` | | 4 | Root Cause Analysis | HIGH | `rca-` | | 5 | Tool Mastery | MEDIUM-HIGH | `tool-` | | 6 | Bug Triage and Classification | MEDIUM | `triage-` | | 7 | Common Bug Patterns | MEDIUM | `pattern-` | | 8 | Fix Verification | MEDIUM | `verify-` | | 9 | Anti-Patterns | MEDIUM | `anti-` | | 10 | Prevention & Learning | LOW-MEDIUM | `prev-` | ## Quick Reference ### 1. Problem Definition (CRITICAL) - `prob-reproduce-before-debug` - Reproduce the bug before investigating - `prob-minimal-reproduction` - Create minimal reproduction cases
Details
- Skill name
debug- Repository
- pproenca/dot-skills
- Path
skills/.curated/debug/SKILL.md- License
- MIT
- Repo updated
- 15 August 2026
FAQ
What does the Debug skill do?
Comprehensive debugging methodology for finding and fixing bugs (formerly debugging). This skill should be used when debugging code, investigating errors, troubleshooting issues, performing root cause analysis, or responding to incidents. Covers systematic reproduction, hypothesis-driven investigation, and root cause analysis techniques. Use when encountering exceptions, stack traces, crashes, segfaults, undefined behavior, or when bug reports need investigation.
How do I install the Debug skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add pproenca/dot-skills --skill debug. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Debug popular?
It lives in pproenca/dot-skills, which has 228 GitHub stars and 19 forks.
Related skills
12 Factor App
228pproenca/dot-skills
The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications. Use when designing backend services, APIs, microservices, or any software-as-a-service application. Triggers on deployment patterns, configuration management, process architecture, logging, and infrastructure decisions.
37signals Rails
228pproenca/dot-skills
37signals Rails coding principles and conventions from DHH, Jorge Manrubia, and the Fizzy/Basecamp/HEY codebase. This skill should be used when writing, reviewing, or refactoring Ruby on Rails code following the 37signals philosophy — vanilla Rails, CRUD controllers, rich domain models, concerns, no service objects, Hotwire, Turbo, Stimulus, Solid Queue, Solid Cache, Solid Cable, multi-tenancy, Minitest, custom auth, or DHH conventions.
Acceptance Pipeline Catalog
228pproenca/dot-skills
Use when implementing, reviewing, or debugging a Gherkin acceptance-test pipeline with mutation testing. Covers parser, JSON IR, generator, runtime, step handlers, test runner, mutator, value mutation rules, execution, result classification, reporting, project layout, conformance, and agent setup. Based on Uncle Bob's Acceptance Pipeline Specification. Trigger even when the user mentions Gherkin parsing, acceptance test generation, mutation testing for acceptance tests, or building a portable test pipeline.
Design Sprint
150guia-matthieu/clawfu-skills
Test big ideas in just 5 days. Apply Google Ventures' proven methodology to go from problem to validated prototype without months of development. Use when: **New product concepts** that need validation before building; **Big feature decisions** with significant investment required; **Stuck teams** needing to break through analysis paralysis; **Startup pivots** when direction is uncertain; **High-risk bets** where failure is expensive
Copy Frameworks
150guia-matthieu/clawfu-skills
Master the essential copywriting frameworks used by top marketers. AIDA, PAS, PASTOR, BAB, FAB, and 4Ps—the building blocks of persuasive copy. Use when: Writing sales copy and need a proven structure; Structuring landing pages, emails, or ads; Overcoming writer's block by following a formula; Teaching copywriting fundamentals to your team; Reviewing copy to identify structural weaknesses
Django Recommender Search Backend Patterns
228pproenca/dot-skills
Django backend patterns for recommendation services (AWS Personalize, Databricks Model Serving, internal microservices) and OpenSearch-backed search/feed endpoints. Covers fan-out orchestration (asyncio.gather, deadline propagation, partial results, async client reuse), external service protection (timeouts, circuit breakers, jittered retry, bulkheads, rate limits), OpenSearch query patterns (search_after, _source filtering, function_score, aliases, routing, bool.filter), result blending (score normalization, MMR, dedup, cold-start), Redis caching (stampede protection, model-versioned keys, tw
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.