Analyze — Read-Only Deep Analysis
SkillFiles & storageThe 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.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
No other account needed.
Ensure the agent has access to the repository you want analyzed.
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
- Ensure the agent has access to the repository you want analyzed.
- Add the analyze skill to the agent's available skills.
- Trigger it by saying analyze, investigate, why does, or what's causing.
- 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
- Restate the question and define the evidence-backed scope.
- Identify the smallest files, tests, configs, and docs likely to answer it.
- Read direct code paths and contracts first; trace boundaries only as far as needed.
- Compare competing explanations, rank them by support, and mark unresolved points.
- 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
| Rank | Explanation | Confidence | Basis |
|---|---|---|---|
| 1 | ... | High / Medium / Low | strongest supporting evidence |
| 2 | ... | High / Medium / Low | why it trails |
| 3 | ... | High / Medium / Low | why 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
github.com/yeachan-heo/oh-my-codex