htlin222

sc-troubleshoot

Diagnose and resolve issues in code, builds, or system behavior. Use when debugging errors, investigating build failures, or resolving deployment issues.

htlin222 79 4 Updated 7mo ago
GitHub

Install

npx skillscat add htlin222/dotfiles/sc-troubleshoot

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no superlatives, no calls to action. At most 60 words. No quotes, no markdown. Just plain text. We need to explain what the skill does, what problem it solves, when to use it. Let's craft: "The skill systematically analyzes code, build, and deployment issues, identifies root causes, and proposes or applies fixes. It is used when debugging errors, investigating build failures, diagnosing performance problems, or resolving deployment issues.

SKILL.md

Issue Diagnosis and Resolution

Systematically diagnose and resolve issues in code, builds, deployments, or system behavior.

When to use

  • Debugging errors and exceptions
  • Investigating build failures
  • Diagnosing performance issues
  • Resolving deployment problems
  • Tracing issues to root cause

Instructions

Usage

/sc:troubleshoot [issue] [--type bug|build|performance|deployment] [--trace]

Arguments

  • issue - Description of the problem or error message
  • --type - Issue category (bug, build, performance, deployment)
  • --trace - Enable detailed tracing and logging
  • --fix - Automatically apply fixes when safe

Execution

  1. Analyze issue description and gather initial context
  2. Identify potential root causes and investigation paths
  3. Execute systematic debugging and diagnosis
  4. Propose and validate solution approaches
  5. Apply fixes and verify resolution

Claude Code Integration

  • Uses Read for error log analysis
  • Leverages Bash for runtime diagnostics
  • Applies Grep for pattern-based issue detection
  • Maintains structured troubleshooting documentation