Analyze — Read-Only Deep Analysis

SkillFiles & storage

The analyze skill is a read-only repository analysis tool for AI agents. It lets your agent deeply analyze a codebase and return a ranked, evidence-backed explanation of findings, with explicit confidence levels, concrete file references, and clear boundaries between evidence and inference. Use it when a user says analyze, investigate, why does, or what's causing, or when a grounded cross-file explanation is needed before any change.

Use Analyze — Read-Only Deep Analysis in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Analyze — Read-Only Deep Analysis and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Analyze skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Ensure the agent has access to the repository you want analyzed.

Analyze — Read-Only Deep AnalysisStart free

What your AI can do with it

  • Run read-only deep repository analysis without modifying files
  • Return a ranked synthesis of findings with explicit confidence
  • Provide concrete file references for each finding
  • Separate evidence from inference in the explanation
  • Support cross-file investigation before any change

Getting started

  1. Ensure the agent has access to the repository you want analyzed.
  2. Add the analyze skill to the agent's available skills.
  3. Trigger it by saying analyze, investigate, why does, or what's causing.
  4. Review the ranked synthesis, confidence levels, and file references.

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 this modify any files?
No. The analyze skill runs read-only deep repository analysis and does not change files.
What kind of output does it produce?
It returns a ranked synthesis with explicit confidence, concrete file references, and clear evidence-vs-inference boundaries.
When should I use this skill?
Use it when a user says analyze, investigate, why does, or what's causing, or when you need a grounded cross-file explanation before any change.
Can it explain why a bug is happening across multiple files?
Yes. It performs cross-file analysis and returns a ranked, evidence-backed explanation of findings.
Does it require write access to the repository?
No. It is read-only, so write access is not needed.
Advanced
Item type
skill
Key
analyze-yeachan-heo
Source
github.com/yeachan-heo/oh-my-codex