diagnose

Diagnose bugs and failures through a four-gate protocol requiring user approval before edits.

4|1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/m2ai-portfolio/m2ai-skills-pack --skill diagnose-m2ai-portfolio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/m2ai-portfolio/m2ai-skills-pack/tree/main/skills/diagnose
Command: npx skills add https://github.com/m2ai-portfolio/m2ai-skills-pack --skill diagnose-m2ai-portfolio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Strict, gate-driven diagnosis of software bugs, failures, and broken pipelines to prevent premature edits and ensure reproducibility.

Core Features & Use Cases

  • Enforces a four-gate process: state the error, gather evidence, list three ranked hypotheses, and obtain explicit user approval before any code changes.
  • Collects and cites logs, environment details, and recent changes to support evidence-based root-cause analysis.
  • Use case: when a test fails or a service is down, apply the protocol to isolate the root cause and plan fixes with user consent.

Quick Start

Describe the error in detail and I will run the four-gate diagnostic protocol.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I diagnose a failing test or service outage without making premature code edits?

To diagnose a failing test or outage without premature edits, apply a strict four-gate protocol: state the error, gather logs and environment details, list ranked hypotheses, and get explicit user approval before changing code.

What is a root-cause analysis protocol for broken software pipelines?

A root-cause analysis protocol for broken pipelines enforces evidence-based debugging by requiring error statements, log collection, and three ranked hypotheses before any code changes are proposed or executed.

How do I structure software bug hypotheses using a diagnostic protocol?

Structure software bug hypotheses by stating the error, collecting environment details and recent changes, then listing three ranked hypotheses to isolate the root cause before proceeding with fixes.

Can I use this diagnostic protocol for both failing tests and production outages?

Yes, you can use this gated diagnostic protocol for failing tests, broken pipelines, and production outages. It requires gathering logs and recent changes to support evidence-based root-cause analysis across various failure types.

What is the best way to prevent premature fixes when debugging failures?

The best way to prevent premature fixes when debugging failures is to enforce a gated protocol that requires explicit user approval after ranking three hypotheses and gathering supporting logs, ensuring reproducibility before edits.