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.