CtrlK
BlogDocsLog inGet started
Tessl Logo

analyze

Run read-only deep repository analysis and return a ranked synthesis with explicit confidence, concrete file references, and clear evidence-vs-inference boundaries. Use when a user says 'analyze', 'investigate', 'why does', 'what's causing', or needs grounded cross-file explanation before any changes are proposed.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is analyze in Yeachan-Heo/oh-my-codex

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable instruction skill with a concrete method, labeling discipline, and output contract. Its weaknesses are repetitive restatement of the read-only/no-overclaim constraint and a single shared-invariants reference that escapes the skill bundle and cannot be verified, which weakens self-contained navigation.

Suggestions

Make the shared-invariants reference self-contained: either inline the relevant rules from templates/AGENTS.md into SKILL.md or ship that file inside the skill bundle (e.g. references/AGENTS.md) so the ../../templates/ path resolves for skill consumers.

Consolidate the read-only/no-overclaim constraint, which is stated four times across the intro, 'Use when', 'Evidence discipline', and 'Stop conditions', into one authoritative statement to trim tokens.

Add a one-row filled example of the 'Ranked synthesis' table (with a real confidence value and basis) so the output contract is unambiguous without interpretation.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows, but the read-only/no-overclaim constraint is repeated four times (intro line, "Do not use it for edits...", "never overclaim certainty" in Evidence discipline, and the Stop conditions section). That places it at the score-4 anchor (efficient with minor instances that could be trimmed) rather than 5's every-token-earns-its-place.

4 / 5

Actionability

As an instruction-only skill it gives fully executable guidance: a 5-step method, an explicit Evidence/Inference/Unknown labeling taxonomy, and a copy-paste-ready output contract with exact section names, table columns (Rank/Explanation/Confidence/Basis), confidence levels, and `path/to/file:line-line` reference format. Per the rubric's code_vs_instruction note this matches the score-5 anchor; score 4 would require missing key details, and none are missing.

5 / 5

Workflow Clarity

"Inputs and method" lists a clear 5-step sequence with an explicit stop condition and an escalation path ("name the smallest read-only probe that would resolve the remaining uncertainty"), plus a separate Stop conditions section. It sits at the score-4 anchor (clear sequence, most checkpoints present, minor gaps) rather than 5 because there is no explicit verify-then-proceed feedback loop on the synthesis itself (e.g., re-checking that every ranked claim has cited evidence before emitting output).

4 / 5

Progressive Disclosure

Sections are well organized and the body is appropriately compact, but the skill's single reference — "[`templates/AGENTS.md`](../../templates/AGENTS.md)" for all shared invariants — points outside the skill bundle and does not resolve to a real file in the reviewed structure, so a consumer cannot navigate to the referenced content and the skill is not self-contained. This lands between the score-3 anchor (structure present but references problematic) and score-4 (references mostly clear); the unverifiable, bundle-escaping path keeps it at 3.

3 / 5

Total

16

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, explicit and comprehensive 'what', and a concrete 'Use when' trigger clause. Its only weakness is trigger synonym coverage and mild overlap with adjacent analysis/review skills.

DimensionReasoningScore

Specificity

"Run read-only deep repository analysis and return a ranked synthesis with explicit confidence, concrete file references, and clear evidence-vs-inference boundaries" names multiple concrete actions (read-only analysis, ranked synthesis, confidence levels, file references, evidence/inference labeling) that comprehensively cover the skill's behavior. It matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since no material capability of the skill is left unlisted.

5 / 5

Completeness

The 'what' is explicit (read-only ranked analysis with confidence, file references, evidence-vs-inference boundaries) and the 'when' is an explicit trigger clause with concrete phrases users would say. Both are clearly answered with concrete triggers, matching the score-5 anchor exactly; score 4 would require the 'when' to be less specific, which it is not.

5 / 5

Trigger Term Quality

"Use when a user says 'analyze', 'investigate', 'why does', 'what's causing', or needs grounded cross-file explanation" gives good natural-phrase coverage, but common synonyms a user would actually say — 'root cause', 'diagnose', 'explain why', 'debug why' — are missing. This fits the score-4 anchor (good keyword coverage; a few natural terms missing) rather than 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The read-only, pre-change, explanation-first scope carves a fairly distinct niche, but broad triggers like 'analyze' and 'investigate' overlap with code-review/debugging skills, and the description itself must exclude "OMX team-runtime operation" — evidence of adjacent-skill overlap. This is the score-4 anchor (mostly distinct; minor overlap risk with closely related skills) rather than 5's minimal-conflict clear niche.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
Yeachan-Heo/oh-my-codex
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.