How does this skill integrate with my existing documentation?

It references your requirements and design docs to verify if the behavior is a bug or a spec gap, and it saves analysis reports to a dedicated troubleshooting folder for future reference.

Does this skill automatically modify my source code?

No. It follows a strict workflow where it first analyzes the problem and presents a fix strategy. It only proceeds to task creation and implementation after you have explicitly approved the plan.

What happens if the root cause is a flaw in the design itself?

The skill identifies this as a 'Specification Bug' or 'Specification Gap' and prompts you to update the design documentation as part of the resolution process.

What is the primary goal of the sdd-troubleshooting skill?

The primary goal is to ensure that software fixes are based on a systematic identification of the root cause rather than guesswork, while ensuring the solution aligns with the original project requirements.

Can I use this for simple syntax errors?

While it can be used for any error, it is most effective for complex logic bugs and system failures where understanding the 'why' is just as important as the 'how' of the fix.

SDD Troubleshooting Claude Code Skill

The sdd-troubleshooting skill introduces a rigorous, evidence-based approach to debugging within the Claude Code environment. By following the Spec-Driven Development (SDD) methodology, it prevents 'guesswork' fixes by enforcing a workflow that includes phenomenon verification, root cause identification, and cross-referencing with requirement and design documents. This skill ensures all bug fixes are intentional, documented in structured reports, and approved by the user before implementation, maintaining high architectural integrity even during urgent troubleshooting.

主な機能

01Mandatory user approval gate for proposed fix strategies before code changes occur.

021 GitHub stars

03Systematic root cause analysis (RCA) to eliminate trial-and-error debugging.

04Automatic generation of structured troubleshooting reports and bite-sized implementation tasks.

05Classification of issues into implementation bugs, specification bugs, or specification gaps.

06Cross-referencing of bugs against docs/requirements and docs/design for specification alignment.

ユースケース

01Investigating user-reported functional defects to ensure fixes don't violate existing design principles.

02Fixing failed CI/CD pipelines, build errors, and broken unit tests with full documentation.

03Analyzing and resolving complex runtime exceptions or intermittent system crashes.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add windschord/claude_skils sdd-troubleshooting

For use in Claude.ai and ChatGPT

Download Skill

主な機能

01Mandatory user approval gate for proposed fix strategies before code changes occur.

021 GitHub stars

03Systematic root cause analysis (RCA) to eliminate trial-and-error debugging.

04Automatic generation of structured troubleshooting reports and bite-sized implementation tasks.

05Classification of issues into implementation bugs, specification bugs, or specification gaps.

06Cross-referencing of bugs against docs/requirements and docs/design for specification alignment.

ユースケース

01Investigating user-reported functional defects to ensure fixes don't violate existing design principles.

02Fixing failed CI/CD pipelines, build errors, and broken unit tests with full documentation.

03Analyzing and resolving complex runtime exceptions or intermittent system crashes.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add windschord/claude_skils sdd-troubleshooting

For use in Claude.ai and ChatGPT

Download Skill

SDD Root Cause Analysis & Troubleshooting

SDD Root Cause Analysis & Troubleshooting

主な機能

ユースケース

主な機能

ユースケース