Diagnose
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
Overview
The Diagnose skill, hosted in the mxyhi/ok-skills repository, provides a systematic framework for resolving complex software defects and performance bottlenecks. Designed for use with agents like Claude, Codex, and OpenClaw, it implements a disciplined six-step diagnostic loop. This process guides the agent through reproduction, minimization of the issue, hypothesis generation, instrumentation, fixing, and final regression testing. By following this structured methodology, the skill helps maintain code quality when users report broken functionality or unexpected system failures. The mxyhi/ok-skills repository, which maintains a popularity of over 400 stars, offers this tool to streamline the troubleshooting process across diverse environments including browser-based applications and ROS-integrated systems, ensuring a rigorous approach to software maintenance.
Use Cases
Install Notes
# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/diagnose/SKILL.mdCopy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.
Security Notes
Users should ensure the AI agent has appropriate permissions to access the local environment for instrumentation and testing. Since this skill involves executing code to reproduce and fix bugs, it is recommended to run the diagnostic loop within isolated or development environments to prevent unintended side effects on production systems.
Related Skills
Internal Comms
anthropics/skills
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project upd...
Planning And Task Breakdown
addyosmani/agent-skills
Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.
Notion Spec To Implementation
openai/plugins
Turn Notion specs into implementation plans, tasks, and progress tracking; use when implementing PRDs/feature specs and creating Notion plans + tasks from them.
Notion Knowledge Capture
openai/plugins
Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.
Notion Research Documentation
openai/plugins
Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.
Notion Meeting Intelligence
openai/plugins
Prepare meeting materials with Notion context and Codex research; use when gathering context, drafting agendas/pre-reads, and tailoring materials to attendees.