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 update
Find Skills
mxyhi/ok-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
caveman
mxyhi/ok-skills
Respond terse like smart caveman. All technical substance stay. Only fluff die.
grill with docs
mxyhi/ok-skills
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
grill me
mxyhi/ok-skills
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
Dogfood
mxyhi/ok-skills
Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step