CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flywheel

Define, review, repair, or set up a repository's agent harness data flywheel: the learning loop that records agent sessions, learns from them by analysis or by replaying them on better models, applies the lessons to instructions, skills, hooks, and memory, prunes scaffolding newer models no longer need, and tunes the loop itself. Use when a repo documents a flywheel (docs/flywheel.md) that needs review or repair, when a repo has no learning loop and needs its first one, or when the user asks how agents should learn across sessions, keep memory, run retros or evals on recorded sessions, or remove harness scaffolding as models improve.

Quality

80%

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 ./.agents/harness/adapters/antigravity/skills/flywheel/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 body is a maximally lean redirect stub: perfectly token-efficient, but it delegates 100% of the skill's substance to an external file outside the bundle with no inline guidance, no error handling if that file is absent, and no overview of what following it entails. It reads as a generated shim rather than a self-contained skill body.

Suggestions

Inline a minimal core workflow (e.g., the steps to review or bootstrap a flywheel, or key sections to look for in docs/flywheel.md) so the skill provides value even when the shared skill file is unavailable.

Add a fallback instruction for when ~/.agents/skills/flywheel/SKILL.md does not exist (e.g., what to do or tell the user), since the referenced path lives outside the skill bundle and cannot be guaranteed to resolve.

Replace or contextualize the 'scripts/agent-harnesses.py' provenance comment, which references a file not present in the bundle and adds no navigational value for the reader.

DimensionReasoningScore

Conciseness

The body is two lines with zero padding or over-explanation: a provenance comment and 'Load and follow the shared skill at ~/.agents/skills/flywheel/SKILL.md'. Every token earns its place; nothing could be trimmed.

5 / 5

Actionability

The only guidance is a redirect to an external path; there are no steps, commands, or examples for any of the promised tasks (define, review, repair, set up a flywheel). A specific path is given so it is not entirely vague, but the executable substance is entirely delegated, fitting 'minimal concrete guidance; missing the specific steps to execute'.

2 / 5

Workflow Clarity

The single directive is unambiguous (load and follow the referenced skill), but there is no validation that the target file exists, no fallback if it is missing, and no sequence for the multi-step flywheel tasks the description promises. It lands at 'steps present but checkpoints missing or implicit' rather than higher.

3 / 5

Progressive Disclosure

The reference is clearly signaled and one level deep, but the body contains no overview content at all and points outside the skill bundle ('~/.agents/skills/flywheel/SKILL.md', plus a 'scripts/agent-harnesses.py' comment for a file not present in the bundle), so navigation depends on an unverified external dependency. This fits 'some structure; references present but organization is incomplete' rather than a well-split overview.

3 / 5

Total

13

/

20

Passed

Description

96%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.

An excellent description: it explicitly states what the skill does with comprehensive, concrete actions and provides explicit, multi-scenario 'Use when' triggers with natural phrasing and synonyms. The only weakness is slight breadth in a couple of trigger phrases ('keep memory', 'run evals') that could overlap with neighboring memory/eval skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full lifecycle: 'Define, review, repair, or set up', 'records agent sessions', 'learns from them by analysis or by replaying them on better models', 'applies the lessons to instructions, skills, hooks, and memory', 'prunes scaffolding', and 'tunes the loop itself'. This matches the comprehensive-coverage anchor; no meaningful capability gaps remain.

5 / 5

Completeness

Both halves are explicit: the 'what' is the detailed first clause enumerating the loop's operations, and the 'when' opens with 'Use when a repo documents a flywheel (docs/flywheel.md) that needs review or repair, when a repo has no learning loop..., or when the user asks how agents should learn across sessions'. This matches the anchor requiring concrete trigger phrases for both.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered with synonyms and concrete artifacts: 'flywheel (docs/flywheel.md)', 'learning loop', 'learn across sessions', 'keep memory', 'run retros or evals on recorded sessions', and 'remove harness scaffolding as models improve'. These are phrases a user would naturally say when needing this skill.

5 / 5

Distinctiveness Conflict Risk

The agent-harness learning-loop niche is clear and mostly distinct, but trigger phrases like 'keep memory' and 'run retros or evals' carry minor overlap risk with general memory-management or eval skills. It fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor.

4 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/flywheel/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.