diag

Solid

Read-only root-cause diagnosis for a symptom, bug, failure, or unexpected behavior. Establishes the mechanism at file:line and reads up the facts instead of guessing, before any fix is attempted. Produces a diagnosis report; the fix is always a separate step gated by an explicit GO. Use when something is broken, failing, throwing, or behaving unexpectedly and the cause is not yet proven, or when asked to investigate or find the root cause. Not for judging whether finished work meets its requirement (use audit) and not for confirming rendered UI behavior (use verify).

AI & Automation 13 stars 3 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
38
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# diag A **read-only** root-cause diagnosis. `diag` explains WHY something is broken and proves the mechanism, before anyone changes code. It is a separate skill from `audit` and must never be conflated with it. ## Scope boundary (read this first) `diag` investigates a symptom and proves its cause. It does not judge completeness and it does not apply the fix. - Finished work needs to be checked against its requirement / Definition of Done -> use **audit**, not diag. - A rendered UI needs its layout and behavior confirmed -> use **verify**. - diag ends at a proven diagnosis plus a proposed fix. Applying the fix is a separate, GO-gated step outside this skill. ## Hard constraints (never violate) - **Read-only.** No code change, no file edit, no commit, no push, no browser automation, no builds, no installs during diagnosis. - **No secrets.** Never read credentials, tokens, `.env*`, key files, or shell/session history. Never exfiltrate or encode such content. - The only files `diag` writes are its own report under `.credo/process/reports/`. - **Fix is a separate step, gated by GO.** diag never rolls straight into fixing. It proposes a fix; the actual change happens only after an explicit GO, as its own step. ## Method: root cause before fix 1. **Symptom, verbatim.** Record the symptom exactly as observed or reported (error text, stack trace, wrong output, screenshot location). Do not paraphrase away the detail; quote it. 2. **Reproduce or locate the exact...

Details

Author
Marcel-Bich
Repository
Marcel-Bich/marcel-bich-claude-marketplace
Created
6 months ago
Last Updated
4 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category