CtrlK
BlogDocsLog inGet started
Tessl Logo

auto-review-loop

Autonomous multi-round research review loop. Repeatedly reviews using Claude Code via claude-review MCP, implements fixes, and re-reviews until positive assessment or max rounds reached. Use when user says "auto review loop", "review until it passes", or wants autonomous iterative improvement.

72

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is highly actionable with a clear, well-checkpointed workflow, but it is not token-lean: polling instructions are duplicated and it carries editorial meta-commentary, while large inline template/schema blocks make it monolithic rather than progressively disclosed.

Suggestions

De-duplicate the MCP polling instructions: state the 'save jobId → poll review_status until done=true → save threadId' pattern once and reference it from Phase A and the Round 2+ template instead of repeating it verbatim.

Remove the stale-wording meta-commentary in the MAX_ROUNDS/POSITIVE_THRESHOLD constants ('Earlier wording used "or" + a stale verdict set...') — keep only the authoritative definition.

Move the full prompt templates and the REVIEW_STATE.json schema into reference files under references/ and link to them from the phases, reducing the inline monolithic block and improving progressive disclosure.

DimensionReasoningScore

Conciseness

Mostly efficient operational detail Claude needs, but includes redundancy and meta-commentary — the MCP polling instructions are repeated nearly verbatim across Phase A (lines 89-91) and the Round 2+ template (line 254), and Constant 17 carries stale-wording commentary ('Earlier wording used "or" + a stale verdict set'); it is not a 1 because no basic concepts are over-explained, and not a 3 because of the duplicated polling text and editorial meta-commentary that could be tightened.

2 / 3

Actionability

Provides fully executable guidance — concrete MCP tool names (mcp__claude-review__review_start / review_status / review_reply_start), ready-to-use prompt-template blocks, a concrete REVIEW_STATE.json schema, explicit file paths, and precise parse rules ('Approval: go, continue, ok, proceed'); not a 2 because the templates and tool calls are concrete rather than pseudocode.

3 / 3

Workflow Clarity

Clear sequence (Initialization → Loop Phases A–E → Termination) with explicit validation checkpoints — the STOP CONDITION gating, the 24-hour staleness/status checks in resume logic, and the review→fix→re-review feedback loop; not a 2 because checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

Has well-signaled one-level-deep external references (the shared-references/output-*.md links in Output Protocols) but the core orchestration is a monolithic inline wall — full prompt templates (duplicated) and the JSON state schema live inline and could be split into reference files; not a 1 because sections are organized and references are not deeply nested, and not a 3 because large blocks of operational content remain inline with no bundle files provided.

2 / 3

Total

10

/

12

Passed

Description

100%

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

The description is strong: it states concrete actions, provides explicit natural-language triggers in a 'Use when...' clause, answers both what and when, and carves a distinct niche. Voice is appropriately third person.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Repeatedly reviews using Claude Code via claude-review MCP, implements fixes, and re-reviews until positive assessment or max rounds reached' — matching the multiple-specific-actions anchor; it is not a 2 because it goes beyond naming a domain to enumerate the loop's operations.

3 / 3

Completeness

Explicitly answers both 'what' (autonomous multi-round review loop that implements fixes and re-reviews) and 'when' via the 'Use when...' clause with explicit triggers; not a 2 because the when is explicit, not merely implied.

3 / 3

Trigger Term Quality

Quotes natural trigger phrases users would say — 'Use when user says "auto review loop", "review until it passes", or wants autonomous iterative improvement' — giving good coverage of common variations; not a 2 because the quoted triggers are concrete utterances rather than generic terms.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (autonomous review loop over Claude Code via the claude-review MCP bridge) with distinct quoted triggers, making wrong-skill activation unlikely; not a 2 because the MCP-review-loop framing is specific rather than a broad document/code category.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository
wanshuiyin/Auto-claude-code-research-in-sleep
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.