diagnose

Automate bug diagnosis with reproduction, hypothesis testing, and regression testing.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ForgePlan/marketplace --skill diagnose-forgeplan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/ForgePlan/marketplace/tree/main/plugins/fpl-skills/skills/diagnose
Command: npx skills add https://github.com/ForgePlan/marketplace --skill diagnose-forgeplan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides an automated approach to diagnose complex bugs and performance regressions, guiding you through a systematic process.

Core Features & Use Cases

  • Disciplined Diagnosis Loop: Walks you through a six-phase process to identify and fix bugs effectively.
  • Feedback Loop Building: Assists in creating a rapid pass/fail signal to streamline debugging.
  • Bug Reproduction and Hypothesis Testing: Aids in reproducible tests and generates ranked hypotheses.
  • Instrumentation and Debugging: Offers debugging techniques and logging guidelines for pinpointing the issue.
  • Regression Testing: Ensures the bug is fixed and verifies through regression tests.
  • Post-Mortem and Cleanup: Guides the post-diagnosis phase with required clean-up actions.
  • Use Case: Ideal for handling intermittent or non-trivial bugs that resist traditional debugging methods.

Quick Start

Execute the /diagnose command followed by the specific details or code snippet that exhibits the bug behavior.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I systematically diagnose intermittent bugs that resist traditional debugging?

To systematically diagnose intermittent bugs, you can use a structured six-phase approach involving bug reproduction, hypothesis testing, instrumentation, and regression testing. This method guides you through creating a rapid pass/fail signal to pinpoint non-trivial issues effectively.

What is the best way to identify performance regressions in my codebase?

The best way to identify performance regressions is by automating the diagnosis loop with structured hypothesis testing and instrumentation. This process builds a rapid feedback loop to isolate the regression source, followed by regression testing to verify the fix.

Can I automate bug reproduction and hypothesis testing for complex system errors?

Yes, you can automate bug reproduction and hypothesis testing for complex system errors. The process aids in creating reproducible tests and generates ranked hypotheses to streamline the debugging of non-trivial bugs across various environments.

How do I start debugging a code snippet that exhibits unexpected behavior?

To start debugging a code snippet with unexpected behavior, execute the diagnosis command followed by the specific details of the issue. This initiates a disciplined diagnosis loop to build a feedback signal and generate ranked hypotheses with minimal setup.

Does automated bug diagnosis require complex environment setup and dependencies?

Automated bug diagnosis requires minimal setup and supports various environments without external dependencies. It leverages internal and external tool integrations to provide structured instrumentation and debugging guidelines directly within your existing workflow.