CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

iterative-retrieval

Pattern for progressively refining context retrieval to solve the subagent context problem

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/iterative-retrieval/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 content presents a genuinely useful, clearly sequenced pattern with strong worked examples and explicit loop-exit criteria, but the code is pseudocode built on undefined helpers and there is modest padding (the Problem section and the ASCII diagram). Tightening those and making the phase functions concrete would raise both conciseness and actionability.

Suggestions

Cut "The Problem" section and the ASCII diagram — the trade-offs are known and the loop is already fully expressed by the iterativeRetrieve code.

Replace or ground the undefined helpers (retrieveFiles, scoreRelevance, extractPatterns, mergeContext) with concrete implementations or a real tool invocation (e.g., grep/glob patterns) so the code is executable rather than illustrative.

Add brief guidance for the failure path — what to do when 3 cycles exhaust without reaching the sufficiency threshold — to complete the feedback loop.

DimensionReasoningScore

Conciseness

The body is mostly efficient — code snippets and worked examples carry real information — but "The Problem" section ("Send everything: Exceeds context limits" / "Send nothing: Agent lacks critical information") restates trade-offs Claude already knows, and the 15-line ASCII diagram duplicates the loop the code already expresses. This fits the anchor for mostly efficient with some unnecessary explanation; not a 4 because those sections are clearly trimmable.

3 / 5

Actionability

The phase code calls undefined helpers (retrieveFiles, scoreRelevance, extractPatterns, mergeContext, hasCriticalGaps), making it illustrative pseudocode rather than executable code, and no flexibility justification is given. The worked examples ("Found auth.ts (0.9), tokens.ts (0.8)" and the terminology-mismatch recovery) and the copy-paste agent prompt block are concrete, so it sits at the pseudocode anchor rather than the high-level-hints anchor of 2 or the mostly-executable anchor of 4.

3 / 5

Workflow Clarity

The four phases are clearly sequenced (DISPATCH → EVALUATE → REFINE → LOOP) with an explicit sufficiency checkpoint ("highRelevance.length >= 3 && !hasCriticalGaps(evaluation)") and a hard stop ("Max 3 cycles, then proceed"), plus a fallback return of bestContext. Not a 5 because there are no explicit validation steps or error-recovery guidance outside the code (e.g., what to do when all cycles exhaust with weak results); not a 3 because checkpoints and the feedback loop are present and explicit.

4 / 5

Progressive Disclosure

The ~210-line body is well-organized with clear sections (When to Activate, four phase sections, Practical Examples, Integration, Best Practices) and is appropriately self-contained for a pattern skill with no bundle files. Minor gaps keep it from a 5: the two full worked examples are detail content that could live in a references file, and the Related section points to a non-bundled skill ("continuous-learning") and an external link rather than well-signaled one-level-deep bundle references.

4 / 5

Total

14

/

20

Passed

Description

50%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 clearly communicates what the skill is, but it omits any when-to-use guidance, relies on a single abstract action phrase, and uses only two or three trigger terms. Adding an explicit "Use when..." clause with the natural failure phrases from the body would lift completeness, trigger term quality, and distinctiveness together.

Suggestions

Append an explicit trigger clause, e.g. "Use when spawning subagents that need codebase context, or when hitting 'context too large' or 'missing context' failures in multi-agent workflows."

Enumerate the concrete actions (dispatch broad queries, evaluate relevance, refine criteria, loop up to 3 cycles) instead of the single abstract phrase "progressively refining context retrieval".

Include natural synonyms users would say — "subagent context", "multi-agent", "RAG-like retrieval", "token usage" — to improve trigger term coverage and reduce overlap with generic retrieval skills.

DimensionReasoningScore

Specificity

The phrase "Pattern for progressively refining context retrieval" names the domain (subagent context) and one moderately concrete action, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because the description never lists the actual mechanisms (dispatch, evaluate, refine, loop) that the body contains, and not a 2 because it goes beyond merely naming a domain.

3 / 5

Completeness

The description gives a clear "what" ("progressively refining context retrieval to solve the subagent context problem") but contains no "Use when..." clause or equivalent trigger guidance, which the judging guidelines cap at 3. It is not a 2 because the "what" is clear rather than vague; it cannot be a 4 without any "when" element at all.

3 / 5

Trigger Term Quality

The terms "context retrieval" and "subagent context problem" are relevant keywords for this domain, but natural user phrases like "missing context", "context too large", or "multi-agent" appear only in the body and are absent from the description, fitting the anchor for some relevant keywords missing common variations. Not a 4 because coverage is only two or three terms with no synonyms; not a 2 because the terms present are domain-specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

"subagent context problem" carves out a recognizable niche, but "context retrieval" broadly overlaps with general RAG, retrieval-pipeline, and context-management skills, fitting the anchor for somewhat specific but still overlapping with similar skills. Not a 4 because nothing in the description (e.g., trigger phrases or unique actions) keeps it from firing for generic retrieval tasks.

3 / 5

Total

12

/

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

valeriibeck-star/claude-skills

Path

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.