Analyze — Read-Only Deep Analysis

SkillFiles & storage

The analyze skill is a read-only repository analysis capability for an AI agent. When someone asks why something happens in a codebase or what is causing a behavior, it traces the relevant files and returns a ranked synthesis with explicit confidence levels and concrete file references. Every claim is labelled as evidence, inference, or unknown, so the agent does not present guesses as fact.

Available today. Use it from your connected AI after setup.

Have a repository the agent can read.

Then ask your AI: use the Analyze skill

What your AI can do with it

  • Restate the question and define the evidence-backed scope
  • Trace relevant files, tests, configs, and docs without editing
  • Rank competing explanations with high, medium, or low confidence
  • Cite specific file and line references for each material claim
  • Label claims as evidence, inference, or unknown
  • Name the smallest read-only probe that would resolve uncertainty

Getting started

  1. Have a repository the agent can read.
  2. Add the analyze skill to the agent's available skills.
  3. Ask a causal or cross-file question, such as why a behavior occurs or what is causing a failure.
  4. Read the ranked synthesis, evidence, inference, and unknowns sections in the response.

What this skill tells your AI

The instructions your AI receives, as published by yeachan-heo/oh-my-codex in skills/analyze/SKILL.md and read by ahel’s review.

Use $analyze to answer a repository question with grounded, read-only evidence. Explain what the code most likely says; do not turn analysis into implementation or generic fix planning.

Shared operating, delegation, state, hook, team, cancellation, and verification invariants live in templates/AGENTS.md. Follow that source instead of duplicating its rules here.

Use when

  • The user needs a causal, architectural, behavioral, impact, or tradeoff explanation.
  • The answer requires tracing multiple files or boundaries, or ranking plausible explanations.
  • The user needs confidence and concrete evidence before changing anything.

Do not use it for edits, implementation, a new product plan, a simple one-file lookup, or OMX team-runtime operation.

Inputs and method

  1. Restate the question and define the evidence-backed scope.
  2. Identify the smallest files, tests, configs, and docs likely to answer it.
  3. Read direct code paths and contracts first; trace boundaries only as far as needed.
  4. Compare competing explanations, rank them by support, and mark unresolved points.
  5. Stop when the question is answered with sufficient evidence, or name the smallest read-only probe that would resolve the remaining uncertainty.

Evidence discipline

Label every material claim as one of:

  • Evidence — directly shown by code, tests, generated artifacts, configuration, or docs.
  • Inference — a reasoned conclusion drawn from cited evidence.
  • Unknown — not settled by the repository evidence.

Prefer direct paths and independent corroboration over contextual clues. Never present guesses as evidence or inference, and never overclaim certainty.

Output contract

Answer the asked question first and use this shape:

Question

Restated question, briefly.

Ranked synthesis

RankExplanationConfidenceBasis
1...High / Medium / Lowstrongest supporting evidence
2...High / Medium / Lowwhy it trails
3...High / Medium / Lowwhy it remains possible

Evidence

  • path/to/file:line-line — direct observation.
  • path/to/file:line-line — corroborating observation.

Inference

  • What the evidence most strongly implies.
  • Why weaker alternatives were down-ranked.

Unknowns / limits

  • What the repository does not establish.
  • The next discriminating read-only probe, when useful.

Stop conditions

  • Do not edit files, run an implementation lane, or make recommendations the evidence cannot support.
  • Do not continue searching after the answer and confidence boundary are grounded.
  • If evidence is insufficient, report the limit explicitly rather than manufacturing certainty.

Task: {{ARGUMENTS}}

Signals

GitHub stars
33k
Forks
3k
Last commit
Oct 2026

Questions

Does the analyze skill edit files?
No. It is read-only and does not edit files, run an implementation lane, or make recommendations the evidence cannot support.
When should the analyze skill be used?
Use it when a user says analyze, investigate, why does, or what's causing, or needs a grounded cross-file explanation before any change is proposed.
How does it handle uncertainty?
Every material claim is labelled evidence, inference, or unknown. Explanations are ranked by support with high, medium, or low confidence, and unresolved points are named.
Advanced
Item type
skill
Key
analyze-yeachan-heo
Source
github.com/yeachan-heo/oh-my-codex