diagnose

Trace reproduced symptoms to root-cause source code with file, line, and confidence rating.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/Thigh-Food/emdash --skill diagnose-thigh-food
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Thigh-Food/emdash/tree/main/.flue/skills/diagnose
Command: npx skills add https://github.com/Thigh-Food/emdash --skill diagnose-thigh-food

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After reproducing a bug, developers still face the slow, error-prone work of locating the exact code responsible. This Skill walks from a reproduced symptom (failing test, stack trace, wrong HTTP response, broken DOM) to the specific file and line that causes it, producing a diagnosis precise enough for a fix stage to act on. ## Core Features & Use Cases - Symptom-to-source tracing: Follows stack frames, return values, render pipelines, and migration paths from the observed symptom back to the originating code. - Known-bug-pattern checklist: Checks recurring culprits such as missing locale filters, unsafe SQL interpolation, pagination off-by-ones, missing awaits, and permission-check gaps. - Honest confidence rating: Rates each diagnosis high, medium, or low, with hypothesis notes for anything below high so maintainers know what to test next. - Use Case: A GitHub issue reports a wrong API response. After the reproduce stage captures the failing request, this Skill reads the handler and data layer, pins the bug to packages/core/src/api/handlers/menus.ts:142, and explains why the missing locale filter produces the symptom. ## Quick Start Ask the AI to diagnose the reproduced bug from the issue notes and return the root-cause file, line, and confidence rating without modifying any code.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I find the root cause of a reproduced bug?

Start from the file, command, or URL named in the reproduce notes, then walk from the symptom to the source: follow stack frames for exceptions, trace return values back to handler boundaries, or identify the rendering component for wrong HTML. Read the candidate code in full before pinning a location.

How to trace a stack trace to the buggy source line?

Read each frame in order starting from the deepest application frame, skipping framework internals, and confirm the call sequence matches what the reproduce stage actually executed. The diagnosis should name a single line or tightly scoped block, not just a file.

What are common bug patterns in TypeScript CMS codebases?

Recurring culprits include missing locale filters on content queries, unsafe SQL identifier interpolation, pagination cursor off-by-ones, missing awaits on ignored promises, non-null assertions hiding undefined handling, missing permission checks, and Lingui t called at module scope.

Can this diagnosis skill modify or fix the code it finds?

No. The skill is strictly read-only: no edits, no test runs, no commits, and no writes to GitHub. It only reads code and returns a root cause, confidence rating, and hypothesis notes for a separate fix stage to act on.

When is a bug diagnosis rated low confidence?

Confidence is low when multiple plausible causes exist that cannot be ruled out without instrumentation, or when the right area is identified but no specific bug is visible. Low and medium diagnoses include hypothesis notes describing alternative causes and what would distinguish them.