CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-review

Adversarially review one ready-for-review ticket task in a read-only Pi subagent using a model different from the worker, then return a structured markdown findings list and a verdict. Use only for the review stage; it never edits code or applies its own findings.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally disciplined instruction-only skill: a lean overview that delegates detail to real, well-signaled reference files, with concrete blocked conditions and an exact output/protocol contract. The only structural gaps are an orphaned script and a contract file not directly reachable from SKILL.md.

DimensionReasoningScore

Conciseness

The body is lean and directive with zero concept explanations — "Determine whether the implementation solves the stated problem. Be adversarial about evidence. Stay inside the task's scope." assumes Claude's competence throughout. The read-only constraint is stated several times ("Remain read-only. Never edit code, tests, plans, or state.", "Never edit or write.", "Do not edit the controller database."), which is minor repetition that could be trimmed, matching anchor 4 rather than 5.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact blocked conditions ("If the model matches the work model, return `blocked`"), exact output contract ("Return only the `factory.review.v4` template in references/output.md. Do not emit a JSON object. Do not wrap the result in a Markdown fence."), and exact protocol handling ("call `subagent_done` once", shutdown-reply behavior). No gaps; every branch has a concrete instruction.

5 / 5

Workflow Clarity

A clear three-stage sequence — isolate the session, review the task, return the verdict — with explicit validation checkpoints up front (model mismatch, mutation tools present, missing packet/diff each produce a named `blocked` outcome) and an error-recovery protocol for the shutdown edge case. Not a destructive/batch operation, so no validation cap applies.

5 / 5

Progressive Disclosure

The body is a clean overview with well-signaled, one-level-deep markdown links to references/reviewer-prompt.md, references/code-quality.md, and references/output.md, all of which exist. Scored against the actual bundle: references/review-contract.md is only reachable via a second hop from reviewer-prompt.md and is never linked from SKILL.md, and scripts/review-packet.py (plus its test) is orphaned with no navigation path — minor organization gaps that fit anchor 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

71%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 specific, well-bounded description that clearly states what the skill does and its scope boundaries. Its main weakness is trigger coverage: it relies on internal pipeline jargon rather than the natural phrases a user would say when they need an adversarial review of a completed task.

Suggestions

Add natural trigger variations to the when-clause, e.g. "Use when a ticket task is marked ready-for-review or when the user asks to review/re-verify a completed ticket task, its diff, or claimed fixes."

Replace or supplement jargon like "Pi subagent" with user-recognizable terms ("a read-only subagent") so the description matches how users actually phrase the request.

Briefly name what the review examines (e.g. acceptance criteria, correctness, code quality) to close the minor specificity gap.

DimensionReasoningScore

Specificity

"Adversarially review one ready-for-review ticket task", "in a read-only Pi subagent using a model different from the worker", and "return a structured markdown findings list and a verdict" list several concrete actions with only minor gaps (what the review covers — behavior, acceptance criteria — is left to the body). It exceeds anchor 3's "1-2 concrete actions" but falls short of anchor 5's comprehensive coverage.

4 / 5

Completeness

The what is explicit (adversarial review in a read-only, model-different subagent returning findings plus verdict) and a "Use only for the review stage" clause supplies the when. This matches anchor 4 (both present, when could be more explicit or specific — e.g. no concrete trigger phrases like "when a ticket task is marked ready-for-review"), not anchor 5.

4 / 5

Trigger Term Quality

Natural keywords like "review", "ready-for-review", and "ticket task" are present, but the description leans on pipeline jargon ("Pi subagent", "the worker") and misses common variations users would say, such as "review the diff/change" or "re-review after fixes". It fits anchor 3's "some relevant keywords but missing common variations or synonyms" better than anchor 4's "good keyword coverage".

3 / 5

Distinctiveness Conflict Risk

"Use only for the review stage; it never edits code or applies its own findings" plus the read-only and different-model constraints carve out a clear niche with distinct triggers, separating it from general code-review and fix/apply skills with minimal conflict risk.

5 / 5

Total

16

/

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

geut/factory-skills

Path

skills/factory-review/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.