CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loop-engineering

Shared loop-engineering reference for COG skills - the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns. Invoke when designing or debugging a skill that iterates (search-verify-retry, scan-until-dry, fetch-retry-gate).

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

82%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 maximally lean delegating stub: it points to a canonical playbook with exact paths, a follow-on rules file, and a precise platform substitution rule. Its weakness is that it carries none of its own substance — no overview of the playbook's contents and no examples — so its value is entirely outsourced to files outside this bundle.

Suggestions

Add a 2-3 sentence overview of what the playbook covers (agent loop, verifiers, termination conditions, named patterns) so the body is not a bare pointer and a reader can decide relevance without opening the external file.

Clarify the relationship between the playbook and '.agents/rules/cog.md' — e.g., whether cog.md rules override the playbook when they conflict — to remove the one ambiguity in the sequence.

State explicitly that '.claude/skills/loop-engineering/SKILL.md' is a separate central playbook (not this file), since the self-referential path invites an infinite read-execute loop if the paths coincide.

DimensionReasoningScore

Conciseness

The five-line body is lean and assumes Claude's competence — 'Read ... and execute it exactly as written — that file is the authoritative playbook. Then follow ...' with one substitution rule — every token earns its place. No padding, no explanation of concepts Claude already knows.

5 / 5

Actionability

The guidance is concrete and executable in form — exact paths ('.claude/skills/loop-engineering/SKILL.md', '.agents/rules/cog.md', '.agents/agents/<name>.md') and a specific tool ('invoke_subagent'). It is not a 5 because all substantive instruction lives in an external file, so the body alone provides no examples or steps for the common cases; it is well above a 3 since nothing is pseudocode or vague.

4 / 5

Workflow Clarity

The sequence is clear and ordered — read and execute the authoritative playbook, then follow '.agents/rules/cog.md', with an explicit conditional rule for worker delegation. Not a 5 because there are no checkpoints clarifying how the playbook's instructions and cog.md rules interact when they conflict; not a 3 because no risky/destructive operation requires validation here.

4 / 5

Progressive Disclosure

References are one level deep and clearly signaled with exact paths, and splitting the substance into a shared canonical playbook is an appropriate content split for a 'shared reference' skill. It falls short of a 5 because the body is a pure pointer with no overview or summary of what the playbook contains, leaving navigation context thin.

4 / 5

Total

17

/

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.

A strong description: it explicitly states what the reference covers and when to invoke it, uses third person, and includes concrete named patterns as triggers. Main weaknesses are topic-list phrasing instead of action verbs and a few missing natural synonyms for iteration/retry scenarios.

DimensionReasoningScore

Specificity

The description lists several specific coverage areas — 'the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns' — which matches the anchor for several specific actions with minor gaps. It falls short of a 5 because these are topic nouns rather than concrete actions (no verbs like extract/fill/merge), so coverage is enumerated but not action-oriented.

4 / 5

Completeness

Both parts are explicit: the 'what' enumerates the reference's contents ('the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns') and the 'when' is a concrete trigger clause ('Invoke when designing or debugging a skill that iterates'). This matches the anchor for clearly and explicitly answering both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

'Invoke when designing or debugging a skill that iterates (search-verify-retry, scan-until-dry, fetch-retry-gate)' provides natural verbs users would say plus three named pattern triggers. Not a 5 because common variations such as 'retry loop', 'iteration limit', or 'verifier' as a standalone trigger phrase are absent; not a 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

'loop-engineering reference for COG skills' carves out a clear niche with distinct triggers tied to iteration patterns, so overlap risk is low. It is not a 5 because generic loop/retry-related requests could plausibly match other iteration-flavored skills before this one.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

huytieu/COG-second-brain

Path

.agents/skills/loop-engineering/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.