CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-iterative-loop

Run tasks in a loop until goals are met — use for iterative refinement, polling, or convergence

54

Quality

62%

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 ./.claude/skills/skill-iterative-loop/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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 is highly actionable and exceptionally well-sequenced with validation checkpoints and feedback loops, especially in Metric Verification Mode. Its main weaknesses are heavy structural redundancy across overlapping sections and a total absence of progressive disclosure — everything lives in one large inline file with no reference splitting.

Suggestions

Consolidate the redundant 'When to Use', 'Best Practices', 'Red Flags', 'Safety Mechanisms', and 'Quick Reference' sections, which restate max-iterations/progress/exit guidance multiple times.

Split the large Metric Verification Mode and the Self-Regulation config tables into separate reference files (e.g. METRIC_MODE.md, SELF_REGULATION.md) and link to them from the overview.

Trim bracketed placeholder templates that duplicate the same structure across Phase 1/2/3 and the exit conditions.

DimensionReasoningScore

Conciseness

The ~700-line body restates the same loop concept across overlapping sections — "When to Use", "Best Practices", "Red Flags - Don't Do This", "Safety Mechanisms", "Self-Regulation (MANDATORY)", and "Quick Reference" all repeat max-iterations/progress-tracking/exit-strategy guidance — matching 'noticeably verbose; several unnecessary padded sections'; not a 3 because the redundancy is substantial rather than incidental, not a 1 because it largely avoids explaining concepts Claude already knows.

2 / 5

Actionability

Metric Verification Mode gives copy-paste-ready commands ("git add -A && git commit -m 'experiment: ...'", "git revert HEAD --no-edit", "mkdir -p .claude-octopus/experiments") plus a concrete JSONL log schema and 9-step execution contract, matching 'mostly executable guidance with minor gaps'; not a 5 because the standard-loop half relies heavily on bracketed fill-in templates rather than executable content.

4 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops — the Safety Validation checklist, Phase 1/2/3 structure, and Metric Mode's 'If metric worsened → REVERT' / 'If errors: fix and re-validate' recovery match 'clear sequence with explicit validation steps, feedback loops for error recovery, checklists'; the destructive/batch cap does not apply because validation is present, and nothing fits the 4 anchor better than this.

5 / 5

Progressive Disclosure

No bundle files exist and the skill is a single ~700-line monolith with good section headers but zero references, while substantial separable content (the full Metric Verification Mode and Self-Regulation config tables) is inlined, matching 'some structure but content that should be separate is inline'; not a 4 because no one-level-deep references are signaled at all, not a 2 because the internal header hierarchy provides real structure rather than minimal organization.

3 / 5

Total

14

/

20

Passed

Description

62%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 cleanly states what the skill does and gives a 'use for' clause covering its main modalities, but relies on somewhat abstract terms and lacks concrete trigger phrases that would push specificity and completeness higher. It is distinct enough from most skills with only minor overlap risk against retry/debug workflows.

Suggestions

Replace abstract modalities with concrete trigger phrasing, e.g. 'Use when the user says loop N times, keep trying until, iterate until X passes, or repeat with refinements.'

Add user-natural synonyms currently missing — 'repeat', 'retry', 'until it works' — to broaden trigger term coverage.

Tighten the 'when' clause to reference explicit user phrases so completeness can reach the top anchor.

DimensionReasoningScore

Specificity

Quotes "Run tasks in a loop until goals are met — use for iterative refinement, polling, or convergence" name the domain plus several action modalities, but refinement/polling/convergence are abstract categories rather than concrete actions, matching the 'names domain and 1-2 concrete actions, not comprehensive' anchor; not a 2 because it lists multiple sub-actions beyond a single generic verb, not a 4 because no truly concrete operations are enumerated.

3 / 5

Completeness

Provides a clear 'what' ("Run tasks in a loop until goals are met") and an explicit 'use for' clause ("use for iterative refinement, polling, or convergence") serving as 'when' guidance, so it is not capped at 3; it lands at 4 because the 'when' is use-case based rather than concrete trigger phrases as required for a 5.

4 / 5

Trigger Term Quality

Includes natural terms "loop", "iterative", "refinement" alongside more technical "polling" and "convergence", but misses common variations users say such as "repeat", "retry", or "until it works", fitting the 'some relevant keywords but missing common variations' anchor; below 4 due to those gaps, above 2 because several genuinely natural keywords are present.

3 / 5

Distinctiveness Conflict Risk

"Run tasks in a loop until goals are met" carves a fairly distinct iterative-loop niche with minimal broad conflict, but has minor overlap risk with closely related retry/debug skills, matching the 'mostly distinct; minor overlap risk' anchor; not a 5 because the phrasing is broad and could brush against skill-debug or retry scenarios.

4 / 5

Total

14

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (726 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
nyldn/claude-octopus
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.