pm-troubleshoot

Diagnose software defect root causes by analyzing code, logs, services, and git history.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/pinkroosterai/PinkRoosterMcp --skill pm-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pm-troubleshoot
Source: https://github.com/pinkroosterai/PinkRoosterMcp/tree/main/.claude/skills/pm-troubleshoot
Command: npx skills add https://github.com/pinkroosterai/PinkRoosterMcp --skill pm-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you pinpoint the root cause of bugs, errors, crashes, and unexpected behavior in your software projects.

Core Features & Use Cases

  • Root Cause Analysis: Systematically traces issues through code, logs, services, and git history.
  • Error Research: Researches error messages online to identify known issues.
  • Diagnosis & Fix: Produces a clear diagnosis with evidence and suggests a specific fix.
  • Use Case: When a user reports "The API is returning a 500 error," this Skill will investigate the API logs, check service health, examine recent code changes, and potentially research the error online to provide a diagnosis and a suggested solution.

Quick Start

Use the pm-troubleshoot skill to diagnose why the user login is failing with error code 'AUTH-102'.

Frequently Asked Questions about pm-troubleshoot

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

FAQPage Schema
How do I systematically debug software crashes and find the root cause?

Systematic debugging involves tracing issues through code, logs, and version control history to pinpoint the root cause of software crashes. This approach researches error messages to provide evidence-based explanations and actionable fixes for unexpected behavior.

How do I diagnose a 500 error returning from my API?

Diagnosing a 500 API error requires investigating API logs, checking service health, and examining recent code changes. Researching the specific error message online helps identify known issues and provide a clear diagnosis with a suggested solution.

What is root cause analysis in software development and when do I need it?

Root cause analysis in software development is the process of tracing defects through code, logs, services, and git history to find the origin of bugs. You need it when diagnosing errors, crashes, or unexpected behavior that lacks an obvious explanation.

How do I fix unexpected behavior by analyzing version control history?

Analyzing version control history helps fix unexpected behavior by isolating recent code changes that introduced the defect. This diagnostic step identifies exactly what changed, providing evidence to explain the bug and suggest a specific, targeted fix.

Can I use this to research error messages online to identify known software issues?

Yes, you can research error messages online to identify known software issues. This diagnostic step investigates the specific error code or message, matching it against existing knowledge to produce an evidence-based explanation and actionable fix.

What is the best way to troubleshoot failing user logins and error codes?

The best way to troubleshoot failing user logins is to diagnose the specific error code by tracing the failure through application logs and code. This systematic debugging workflow identifies the root cause and suggests an actionable fix for the authentication issue.