CtrlK
BlogDocsLog inGet started
Tessl Logo

iterative-retrieval

Max-3-cycle protocol for agent sub-tasks with WHY context and coordinator validation. Use when spawning sub-agents to complete scoped work.

70

Quality

86%

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.

The skill body is highly actionable with a concrete template, executable commands, and an explicit multi-cycle workflow with validation checkpoints. It is well-organized and self-contained; minor tightening of the anti-patterns section could improve conciseness.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence without over-explaining basic concepts; minor instances of padding (e.g., the anti-patterns list partly restates earlier rules), so it sits above 3 but short of fully lean at 5.

4 / 5

Actionability

Provides a copy-paste spawn template with concrete placeholders, an executable `gh issue list --search ...` command, explicit checkbox success criteria, and worked good/bad examples — fully executable guidance covering common cases.

5 / 5

Workflow Clarity

The 3-cycle protocol is clearly sequenced with a table of exit conditions, explicit coordinator validation after each cycle, escalation feedback loops, and a 'no cycle 4' hard stop with a checklist — matching the anchor for explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

Content is well-structured with clear section headers and no nested references, and no bundle files exist to reference; it is a single self-contained file rather than an overview pointing outward, so it lands at good structure with minor organization gaps rather than the top anchor.

4 / 5

Total

18

/

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.

The description is concise and concrete, clearly stating both the capability and an explicit trigger clause. It could broaden its natural trigger-term coverage (e.g., 'delegate', 'hand off') but is otherwise strong.

DimensionReasoningScore

Specificity

Names the domain (agent sub-tasks) and several concrete actions — 'Max-3-cycle protocol', 'WHY context', 'coordinator validation' — with only minor coverage gaps, matching the 'lists several specific actions' anchor; not a 5 because coverage isn't comprehensive, not a 3 because it clearly exceeds 1-2 actions.

4 / 5

Completeness

Explicitly answers both what ('Max-3-cycle protocol for agent sub-tasks with WHY context and coordinator validation') and when ('Use when spawning sub-agents to complete scoped work') with a concrete trigger phrase, matching the top anchor; not a 4 because the 'when' clause is concrete and explicit rather than weak.

5 / 5

Trigger Term Quality

Includes natural trigger phrasings like 'spawning sub-agents' and 'scoped work' that a user might say, but misses common variations such as 'delegate' or 'hand off'; matches 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The sub-agent spawning protocol with cycles and validation is a distinct niche with minimal conflict risk, though it could lightly overlap with generic agent-coordination skills; matches 'mostly distinct; minor overlap risk'.

4 / 5

Total

17

/

20

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
bradygaster/squad
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.