Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15.

Custom licenceAuto-check passedAgent Workflows

Install Ad Diagnose

skills CLI
$ npx skills add alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alexandremendoncaalvaro/CorridorKey-Runtime ad-diagnose --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ad-diagnose .claude/skills/ad-diagnose && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ad-diagnose
GitHub stars
756
Used in
1 other repo
Token cost
~2.6k tokens
SKILL.md length
1,491 words
Files
2
Skills in repo
26
Repo updated
First seen
Licence
Custom licence

At a glance

Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15.

  • Works in 10 steps: Failing test at the seam closest to the… → Curl / HTTP script against a running dev… → CLI invocation with a fixture input,… → …
  • This is throwing
  • Calls git
  • Performance regression

What it does

Ad Diagnose is an agent skill from alexandremendoncaalvaro/CorridorKey-Runtime. Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15. Five phases — build a feedback loop, reproduce, hypothesise (3-5 ranked falsifiable), instrument, fix + regression-test. The feedback loop is the skill; everything else is mechanical. Triggers on "diagnose this", "debug this", "this is broken", "this is throwing", "performance regression", "find the bug", "build a repro", "feedback loop", "ranked hypotheses", "falsifiable", "/ad-diagnose". Routes to ad-spike when the technique…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering Requirements gathering. The repository describes itself as: Native AI keying runtime and OFX plugin for DaVinci Resolve, built in collaboration with Corridor Digital.

When your agent uses it

  • This is throwing
  • Performance regression
  • Ranked hypotheses

Example prompts

  • “diagnose this”
  • “debug this”
  • “this is broken”
  • “/ad-diagnose”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Failing test at the seam closest to the bug — unit, integration, or e2e.
  2. Curl / HTTP script against a running dev server.
  3. CLI invocation with a fixture input, diffing stdout against a known-good snapshot.
  4. Headless browser script (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
  5. Replay a captured trace — save a real network request / payload / event log, replay it through the code path in isolation.
  6. Throwaway harness — minimal subset of the system (one service, mocked deps) exercising the bug code path in a single function call.
  7. Property / fuzz loop — for "sometimes wrong output", run 1000 random inputs and look for the failure mode.
  8. Bisection harness — if the bug appeared between two known states, automate "boot at state X, check, repeat" so git bisect run can drive it.
  9. Differential loop — same input through old vs new (or two configs), diff outputs.
  10. HITL bash script — last resort. If a human must click, drive them with a structured loop so the signal still flows back.

What it can do on your machine

Read from SKILL.md and the folder at commit e632fa5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ad Diagnose loads about 2.6k tokens when it runs. Until then it costs about 167 tokens; SKILL.md has 1,491 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~167
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,491 words (~2,624 tokens).

“Implements WORKFLOW.md §15 per ADR-0021 (doc/adr/0021-diagnose-discipline.md). Disciplined diagnosis for hard bugs and performance regressions. Process scaffold; the output is the verified fix + regression test landing through normal commits.”

— opening of SKILL.md by alexandremendoncaalvaro, Custom licence
name
ad-diagnose
summary
Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15. Five phases — build a feedback loop (the skill itself), reproduce…

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/ad-diagnose of alexandremendoncaalvaro/CorridorKey-Runtime.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e632fa5

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alexandremendoncaalvaro/CorridorKey-Runtime, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ad Diagnose next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ad Diagnose compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ad Diagnose this skillalexandremendoncaalvaro/CorridorKey-Runtime7561 repos~2.6kAutomated safety check: PassCustom licence
Grillingpietheinstrengholt/rssmonster56431 repos~510Automated safety check: PassMIT
Using LoopkitArchive228/loopkit755—~1.4kAutomated safety check: PassMIT
Deep Divebyungjunjang/jangpm-meta-skills120—~2.5kAutomated safety check: PassNone
Grillingopencrvs/opencrvs-core1202 repos~205Automated safety check: PassCustom licence
Absolute Workmaddhruv/absolute219—~5.3kAutomated safety check: PassMIT

Similar skills

  • Grilling

    pietheinstrengholt/rssmonster

    Grill the user relentlessly about a plan, decision, or idea.

    564 GitHub starsUsed in 31 repos~510 tokens
    Agent WorkflowsAuto-check passed
  • Using Loopkit

    Archive228/loopkit

    A skill your agent uses when starting any conversation in a loopkit-enabled project - establishes how to find and use loopkit's 49 skills, requiring skill invocation before ANY response including…

    755 GitHub stars~1.4k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Deep Dive

    byungjunjang/jangpm-meta-skills

    Socratic interview skill to deepen a spec or refine an existing agent blueprint.

    120 GitHub stars~2.5k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Grilling

    opencrvs/opencrvs-core

    Grill the user relentlessly about a plan or design. An agent skill from opencrvs/opencrvs-core.

    120 GitHub starsUsed in 2 repos~205 tokens
    Agent WorkflowsAuto-check passed
  • Absolute Work

    maddhruv/absolute

    End-to-end, phase-gated SDLC for AI coding agents: relentless design interview → reviewed spec → dependency-graphed task board → safe-wave TDD execution → verification → converge.

    219 GitHub stars~5.3k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Deep Dive

    byungjunjang/jangpm-meta-skills

    A Codex skill for Socratic interviews that deepen a spec or refine an existing agent blueprint.

    120 GitHub stars~2.7k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

More from alexandremendoncaalvaro/CorridorKey-Runtime

All 26 skills in this repo
  • Ad Archive

    alexandremendoncaalvaro/CorridorKey-Runtime

    Sweep completed plan files (tasks Status:done, specs Status:shipped, PRDs Status:superseded, ADRs Status:superseded or deprecated) out of the working tree and into git history via git rm.

    756 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Ad Commit

    alexandremendoncaalvaro/CorridorKey-Runtime

    Atomic Conventional Commits with DCO Signed-off-by sign-off.

    756 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Ad Bootstrap

    alexandremendoncaalvaro/CorridorKey-Runtime

    Generate AGENTS.md at the repo root by scanning the codebase first, pre-filling placeholders from observed signals, and asking only the genuine gaps.

    756 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: warnings
  • Ad Deepen

    alexandremendoncaalvaro/CorridorKey-Runtime

    Surface deepening opportunities in the codebase using the Ousterhout/Feathers vocabulary from WORKFLOW §8 (Module / Interface / Depth / Seam / Adapter / Leverage / Locality).

    756 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Ad Domain

    alexandremendoncaalvaro/CorridorKey-Runtime

    Lazily create or update CONTEXT.md (Layer 2 — ubiquitous language per Evans 2003) at the repo root, or CONTEXT-MAP.md plus per-context CONTEXT.md for multi-context repos.

    756 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Ad Grill Me

    alexandremendoncaalvaro/CorridorKey-Runtime

    Interview-before-research grilling session that challenges a fuzzy ask against the existing codebase, sharpens vocabulary against CONTEXT.md, and resolves the decision tree branch by branch.

    756 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

Questions about Ad Diagnose

What does Ad Diagnose do?

Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15. Ad Diagnose is an agent skill from alexandremendoncaalvaro/CorridorKey-Runtime. Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15.

When should I use Ad Diagnose?

Ad Diagnose fits situations like: this is throwing; performance regression; ranked hypotheses.

How do I install Ad Diagnose in Claude Code?

Run `npx skills add alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose -a claude-code`. Or copy the skill folder (.agents/skills/ad-diagnose in alexandremendoncaalvaro/CorridorKey-Runtime) into .claude/skills/ad-diagnose in your project. Claude Code loads it when a task matches its description.

How do I install Ad Diagnose in Codex?

Run `npx skills add alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose -a codex`. Or copy the skill folder (.agents/skills/ad-diagnose in alexandremendoncaalvaro/CorridorKey-Runtime) into .agents/skills/ad-diagnose in your project. Codex loads it when a task matches its description.

Can I use Ad Diagnose in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ad-diagnose, .gemini/skills/ad-diagnose, .github/skills/ad-diagnose and .opencode/skills/ad-diagnose in your project.

What does Ad Diagnose need to run?

Going by SKILL.md and its folder, Ad Diagnose needs the command-line tools its instructions call (git).

Does Ad Diagnose access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ad Diagnose safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ad Diagnose use?

Ad Diagnose has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Ad Diagnose use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ad Diagnose?

Skills that share tags, products or a category with Ad Diagnose: Grilling (pietheinstrengholt/rssmonster, 564 stars), Using Loopkit (Archive228/loopkit, 755 stars), Deep Dive (byungjunjang/jangpm-meta-skills, 120 stars) and Grilling (opencrvs/opencrvs-core, 120 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ad Diagnose?

alexandremendoncaalvaro (a GitHub user) maintains it in alexandremendoncaalvaro/CorridorKey-Runtime, which has 756 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on August 5, 2026.

Source: alexandremendoncaalvaro/CorridorKey-Runtime on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.