CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

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

The canonical home for this skill is iterative-retrieval in bradygaster/squad

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.

A well-structured, highly actionable protocol document: the workflow is explicitly sequenced with validation checkpoints, feedback loops, and escalation rules, and the spawn template plus gh command are copy-paste ready. The only notable gaps are mild cross-section repetition and a single-file layout slightly longer than an ideal overview.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — no explanations of known concepts, and the 3-cycle table and checklists are token-dense. However, the WHY requirement, cycle cap, and validation rule are each restated across the intro, Rules, and Anti-Patterns sections, which is minor repetition that could be trimmed.

4 / 5

Actionability

The guidance is fully executable for an instruction-only skill: a copy-paste-ready spawn prompt template with fill-in sections and worked examples, an executable dedup command (`gh issue list --search "<keywords>" --state open`), checkbox success criteria, and contrasting good/bad spawn prompt examples covering the common cases.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced (spawn with 4 mandatory sections → cycle → coordinator validates against a checklist → delta-forwarded retry → cycle-3 escalation) with explicit validation checkpoints and a feedback loop ('If any item fails → do not accept. Spawn cycle N+1 ... with specific deltas'), plus checklists and a retry-vs-escalate decision table.

5 / 5

Progressive Disclosure

The single file is well-organized with clear section headers and no nested or buried references, and at ~150 lines a single file is a reasonable placement. It scores below 5 because the good/bad spawn prompt examples (and possibly the dedup and output-requirement sections) could be split into a separate reference file to keep SKILL.md a leaner overview.

4 / 5

Total

18

/

20

Passed

Description

75%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 that explicitly covers both what the skill does and when to use it, with a natural primary trigger phrase ("spawning sub-agents"). It is held back from top marks by noun-heavy specificity that omits several of the skill's actual behaviors and by thin trigger-synonym coverage.

Suggestions

Add natural trigger variations such as 'delegating to sub-agents', 'handing off scoped tasks', or 'agent handoffs' to broaden keyword coverage.

Mention one or two more concrete capabilities (e.g., issue dedup check before creating GitHub issues, escalation to a decision inbox after 3 failed cycles) to make the 'what' more comprehensive and action-oriented.

DimensionReasoningScore

Specificity

The description names the domain ("agent sub-tasks") and several concrete protocol elements ("Max-3-cycle", "WHY context", "coordinator validation"), listing several specific mechanisms with minor gaps — it omits other mandated behaviors like the issue dedup check and the escalation path, and uses noun-heavy phrasing rather than action verbs, keeping it below anchor 5.

4 / 5

Completeness

It answers both questions explicitly: the "what" is the three-component protocol ("Max-3-cycle protocol ... with WHY context and coordinator validation") and the "when" is a clear "Use when spawning sub-agents to complete scoped work" clause. The "when" is a single trigger clause without multiple concrete trigger variations, so it falls just short of anchor 5; it is well above anchor 3 because neither part is missing or merely implied.

4 / 5

Trigger Term Quality

"spawning sub-agents", "sub-tasks", and "scoped work" are natural phrases a user would say when needing this skill, giving good keyword coverage; a few natural synonyms like "delegate to an agent", "handoff", or "dispatch" are missing, so it does not reach comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The description targets a clear niche (cycle-capped sub-agent coordination with mandatory validation) with distinct triggers around spawning sub-agents, so it is mostly distinguishable; there is minor overlap risk with other agent-coordination or delegation skills, which keeps it below anchor 5's minimal-conflict bar.

4 / 5

Total

16

/

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.

Validation — 15 / 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

Path

.squad-templates/skills/iterative-retrieval/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.