CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

adversarial-reviewer

Tough, critical review of a diff or PR before merge, through hostile reviewer personas that catch shared blind spots. Use whenever the user wants a change torn apart, a harsh second opinion, or a self-review felt too agreeable.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./engineering-team/skills/adversarial-reviewer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a highly actionable, well-sequenced instruction skill — exact commands, per-persona checklists, feedback loops, and a copy-paste output format. Its one real weakness is token efficiency: the front matter of the body (Description/Features/Problem This Solves) and a verbatim duplicated Quick Start block spend tokens without adding operational value.

Suggestions

Delete the 'Description', 'Features', and 'Problem This Solves' sections — they restate the frontmatter and the persona sections in marketing voice — and fold the one-sentence rationale into the top of the workflow.

Remove one of the two identical code blocks ('Usage' and 'Quick Start' are verbatim duplicates) and drop the Table of Contents for a body this length.

DimensionReasoningScore

Conciseness

The operational core (personas, workflow, severity table, output template, anti-patterns) is tight and high-value, but the front sections pad the body: 'Description', 'Features', and 'Problem This Solves' duplicate each other and the frontmatter, and 'Quick Start' repeats the 'Usage' code block verbatim. This is 'mostly efficient but could be tightened' (anchor 3) rather than anchor 2, since the padding is confined to the header sections and the bulk earns its tokens.

3 / 5

Actionability

Fully executable for an instruction-only skill: exact git commands with fallback logic ('Run git diff (unstaged) + git diff --cached (staged). If both empty, run git diff HEAD~1'), concrete per-function review questions for each persona, a copy-paste markdown output template, explicit severity definitions, and deterministic verdict rules. Nothing remains abstract; anchor 5.

5 / 5

Workflow Clarity

Four clearly sequenced steps with explicit checkpoints and feedback loops: the empty-diff fallback with 'stop and report: Nothing to review', the retry loop 'If a persona finds nothing wrong... go back and look again', and the dedupe/promote synthesis step. The operation is read-only, so the destructive/batch validation cap does not apply; this matches anchor 5 (clear sequence, feedback loops, checklists).

5 / 5

Progressive Disclosure

No bundle files exist, and this prompt-only skill keeps all content in one file with a table of contents, consistent section headers, and clear navigation; the inline persona definitions are execution-time instructions rather than reference material, so a single file is defensible. It holds at anchor 4 rather than 5 because the duplicated Usage/Quick Start blocks and marketing-style front sections ('Features', 'Problem This Solves') slightly muddy the overview, and a 230-line body could shed weight to references or deletion.

4 / 5

Total

17

/

20

Passed

Description

70%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 solid description with correct third-person voice, an explicit 'Use whenever...' trigger clause, and distinctive adversarial framing. Its main weaknesses are incomplete capability coverage and trigger phrasing that misses the most common natural formulations like 'code review'.

Suggestions

Enumerate the concrete outputs in the description — e.g., severity-classified findings (CRITICAL/WARNING/NOTE) and a BLOCK/CONCERNS/CLEAN verdict — to lift specificity from naming the domain to listing several specific actions.

Add the highest-frequency natural trigger phrases ('code review', 'review my PR before merge') to the when-clause, and rephrase 'a self-review felt too agreeable' into smoother user-facing wording.

DimensionReasoningScore

Specificity

Names the domain ('review of a diff or PR before merge') and a concrete mechanism ('hostile reviewer personas that catch shared blind spots'), but coverage is incomplete — no mention of severity classification, verdicts, or the multi-persona structure. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, since it does not list several distinct specific actions.

3 / 5

Completeness

Explicitly answers both: what ('Tough, critical review of a diff or PR before merge, through hostile reviewer personas') and when ('Use whenever the user wants a change torn apart, a harsh second opinion, or a self-review felt too agreeable'). The when-clause contains concrete trigger phrases but uses awkward constructions ('a self-review felt too agreeable') and omits the obvious pre-merge-review case, so it sits at anchor 4 rather than the fully explicit anchor 5.

4 / 5

Trigger Term Quality

Includes natural phrases users would say — 'a change torn apart', 'a harsh second opinion', 'self-review', 'diff', 'PR', 'before merge' — giving good keyword coverage. It falls short of anchor 5 because common variations like 'code review', 'review my PR', or 'critique' are missing, but exceeds anchor 3 since multiple natural trigger phrases are explicitly present.

4 / 5

Distinctiveness Conflict Risk

The adversarial framing ('hostile reviewer personas', 'torn apart', 'harsh second opinion') carves a clear niche with distinct triggers, but the base action 'review of a diff or PR' overlaps with general code-review skills — minor overlap risk with closely related skills, matching anchor 4.

4 / 5

Total

15

/

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

alirezarezvani/claude-skills

Path

engineering-team/skills/adversarial-reviewer/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.