CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

examine

Review a code change rigorously — a PR, branch, commit range, or the working tree. Confirm the problem is real, sketch the obvious solutions before reading the diff, then audit it for correctness, completeness, architecture, conventions, security, privacy, testing, reversibility, and dependencies, judge whether it is right-sized, and verify every significant finding independently. Returns a six-signal report: done well, gaps, issues rated Critical to Low with a separate confidence verdict, questions, suggestions, known limitations. Use when the user says "/examine", "examine this PR", "review this PR", "review pr #N", "review my branch", "look over my pull request", "check my PR before merge", or asks for a deep code review. Holistic where the host's built-in review is defect-first.

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 tightly engineered instruction skill: lean to the point of terse, fully actionable with real git/gh commands, and a workflow whose validation gates and feedback loops are integral rather than bolted on. The single structural weakness is that two of the six referenced paths live outside the skill's own bundle and do not resolve in the provided file layout, slightly undercutting the otherwise model reference table.

Suggestions

Ship assets/writing.md and scripts/prose-lint.py as part of the skill's own bundle (e.g. under references/ or scripts/ within the skill directory), or document that they are host-plugin files, so every path in the Required references table resolves from the skill alone.

Add a one-line fallback for step 8–9 when ../../assets/writing.md or scripts/prose-lint.py is absent (e.g. proceed with the report-template rules in references/report.md and skip linting), so the workflow degrades gracefully outside the full plugin install.

DimensionReasoningScore

Conciseness

The body is dense operational instruction with zero padding — e.g. "Trust nothing. The description, the diff, green tests, and your own candidates are claims. They become findings only after step 7." — and no explanations of concepts Claude already knows. Not 4: there is no over-explanation left to trim; every line directs a step, a rule, or a gate.

5 / 5

Actionability

Concrete, executable commands throughout: "`gh pr view <N>`, `gh pr diff <N>`, and `gh pr checks <N>`", "`git show <merge-base>:<path>`", "`git worktree add --detach`", and a lint script to run on the output, each bound to a numbered step. Not 4: as an instruction-only skill the guidance is fully actionable — every step names what to read, run, or record, with no pseudocode or vague direction.

5 / 5

Workflow Clarity

Nine clearly sequenced steps with explicit validation gates — step 3 ("Confirm the problem exists in the base snapshot"), step 4 approach gate, step 7 ("Give every Medium or higher candidate an independent verdict") — plus a recorded end-state comparison and a feedback loop: "If one does not, go back to the step that produces it." Not 4: checkpoints and recovery loops are explicit at every stage, not merely present.

5 / 5

Progressive Disclosure

The overview is lean and the reference table ("Read at" / "Holds" columns) is exemplary signaling, with audit.md, verify.md, report.md, and rationalizations.md all present and matching their described content. Not 5: two referenced paths — "`../../assets/writing.md`" and "`<plugin root>/scripts/prose-lint.py`" — do not resolve within the provided bundle, so a reader following the table hits unresolvable files. Not 3: all in-bundle structure is appropriately split and clearly navigable.

4 / 5

Total

19

/

20

Passed

Description

96%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.

An exemplary description: third-person, comprehensive in its action list, explicit about both capability and trigger conditions, with concrete user phrasings. Its only weakness is that several of its natural trigger phrases are generic to the crowded code-review domain, creating minor overlap risk with a host's built-in review skill, partially mitigated by the explicit differentiation in the final line.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Confirm the problem is real", "audit it for correctness, completeness, architecture, conventions, security, privacy, testing, reversibility, and dependencies", "verify every significant finding independently" — plus a named deliverable ("six-signal report"), matching the comprehensive-coverage anchor. Not 4: there are no noticeable gaps in the action coverage.

5 / 5

Completeness

Explicitly answers both questions: the "what" is the full audit-and-verify workflow with its output format, and the "when" is a literal "Use when the user says…" clause with concrete trigger phrases — the exact structure of the anchor-5 example. Not 4: the "when" could not be more explicit.

5 / 5

Trigger Term Quality

Eight natural trigger phrases — "/examine", "examine this PR", "review this PR", "review pr #N", "review my branch", "look over my pull request", "check my PR before merge", "deep code review" — covering the synonyms users actually say (PR/pull request/branch). Not 4: no commonly used variant is meaningfully missing.

5 / 5

Distinctiveness Conflict Risk

The closing line "Holistic where the host's built-in review is defect-first" carves out a clear niche, but generic triggers like "review this PR" and "deep code review" are exactly what built-in or sibling code-review skills would claim — minor overlap risk with closely related skills. Not 5: conflict risk is reduced, not minimal; not 3: the niche and differentiators are explicitly stated.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

korya/swd-skills

Path

skills/examine/SKILL.md

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.