sy-review

Review the completed slice for correctness, risk, evidence gaps, and next-stage blockers. Use when the user asks for review, PR readiness, risk assessment, blocker identification, or post-work verification.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%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 concise, well-structured orchestration skill body with an explicit numbered procedure, fail-fast validation, and clean one-level-deep references to verified bundle files. The only minor gap is slightly abstract command references ('repository wrapper') that keep actionability just below maximum.

Dimension	Reasoning	Score
Conciseness	The body is lean and sectioned, assumes Claude's competence, and never over-explains known concepts; every line is instructional, matching the 'lean and efficient; every token earns its place' anchor.	5 / 5
Actionability	Concrete instructional guidance ('classify each lane as pass, fail, blocked, or not_checked'; 'run plugin validation and SDK proof commands from the repository wrapper') with minor abstraction; not 5 because commands reference an unnamed 'repository wrapper' rather than copy-paste specifics (acceptable for an instruction-only skill).	4 / 5
Workflow Clarity	A clear five-step procedure with an explicit fail-fast validation checkpoint ('stop at the first failed required gate') and error-recovery routing in Failure modes, matching the 'clear sequence with explicit validation steps' anchor.	5 / 5
Progressive Disclosure	The body is a concise overview pointing to four real, one-level-deep, verified reference files (contract.yaml, evals.yaml, task-profile.json, source-context.yaml) with clear signaling, matching the top anchor.	5 / 5
	Total	19 / 20 Passed

Description

83%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 well-constructed description that clearly states both what the skill does and when to invoke it, with natural trigger terms and concrete review categories. The main gap is mild overlap risk from the generic term 'review' and a lack of synonym variants.

Suggestions

Add a distinguishing qualifier to the trigger (e.g., 'lifecycle review' or 'post-slice review') to reduce overlap with general code-review skills.

Include a synonym variant such as 'code review' or 'verification pass' among the 'Use when' triggers to broaden natural phrasing coverage.

Dimension	Reasoning	Score
Specificity	Names the review domain plus several concrete objects (correctness, risk, evidence gaps, blockers), matching the 'several specific actions; minor gaps' anchor; not 5 because the actions are abstract categories rather than fully concrete operations.	4 / 5
Completeness	Explicitly answers both what ('Review the completed slice for correctness, risk, evidence gaps, and next-stage blockers') and when ('Use when the user asks for review...') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	'Use when the user asks for review, PR readiness, risk assessment, blocker identification, or post-work verification' gives good natural keyword coverage a user would actually say; not 5 because it lacks synonyms/variants like 'code review'.	4 / 5
Distinctiveness Conflict Risk	Scoped to a post-work lifecycle review stage with mostly distinct triggers; not 5 because the standalone word 'review' is broad and could overlap with general code-review skills.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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: jscraik/Agent-Skills
Path: Plugins/synaipse-harness/skills/sy-review/SKILL.md
Commit: f1f2f21

Reviewed: ~6 hours ago

Table of Contents

Discovery Implementation Validation

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.