troubleshoot

Guide users through a five-step debugging loop with WORKLOG documentation.

69|7|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/TaylorHuston/local-life-manager --skill troubleshoot-taylorhuston
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/TaylorHuston/local-life-manager/tree/main/.claude/skills/troubleshoot
Command: npx skills add https://github.com/TaylorHuston/local-life-manager --skill troubleshoot-taylorhuston

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined approach to debugging by guiding users through a five-step loop to identify, diagnose, and fix issues in codebases and projects.

Core Features & Use Cases

  • Five-Step Debug Loop: Research → Hypothesize → Implement → Test → Document to structure problem-solving sessions.
  • Contextual Workflows: Works across spaces/[project]/ contexts and supports both targeted debugging and general sessions.
  • Collaborative Logging: Encourages thorough documentation and WORKLOG updates to track progress and reproducibility.

Quick Start

/troubleshoot yourbench "tests failing after auth changes" /troubleshoot yourbench 001 # Debug in context of issue /troubleshoot coordinatr # General debugging session

Frequently Asked Questions about troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I systematically debug failing tests in my codebase?

Systematic debugging of failing tests uses a structured five-step loop: Research, Hypothesize, Implement, Test, and Document. This workflow guides you through investigating failures, forming hypotheses, applying fixes, and verifying results in your codebase.

What is the best way to document debugging progress in a project worklog?

Documenting debugging progress in a worklog involves recording findings during the Research phase and updating the log after testing. This collaborative logging tracks reproducibility and ensures all codebase changes are documented for future reference.

How do I structure a debugging workflow for a specific project context?

Structuring a debugging workflow for a project context requires initiating a session within a designated space or issue number. The process applies the five-step debug loop to research the codebase, hypothesize fixes, implement snippets, and test outcomes.

Can I use this debugging approach for general project issues or only specific test failures?

This debugging approach supports both general project issue sessions and targeted test failure debugging. By referencing a specific project or issue context, the workflow adapts to investigate broad codebase problems or isolated test failures.

Why should I use a structured debugging loop instead of ad hoc troubleshooting?

A structured debugging loop provides a disciplined approach to troubleshooting by ensuring you research, hypothesize, and document every step. Unlike ad hoc methods, it produces a worklog that guarantees reproducibility and tracks all codebase modifications.

Does this troubleshooting method require spawning contextual research for codebase errors?

Yes, this troubleshooting method requires spawning contextual research to investigate codebase errors effectively. This research phase initiates the five-step loop, allowing you to gather necessary findings before hypothesizing and implementing code snippets.