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

94%

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 flywheel in phatblat/dotfiles

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.

The body is a deliberately minimal, generated stub that cleanly delegates to a shared canonical skill — maximally concise and unambiguous, but entirely dependent on an out-of-bundle file. Structure and clarity are good; the only weaknesses are the total absence of inline guidance and a dangling generator-script reference.

Suggestions

Add a one-to-two line summary of the flywheel loop's core stages (record → learn → apply → prune → tune) so the skill remains actionable if `~/.agents/skills/flywheel/SKILL.md` is missing on the user's machine (addresses actionability).

Resolve the dangling `scripts/agent-harnesses.py` reference — either ship the generator in the bundle's `scripts/` directory or drop the path from the comment — so all referenced paths exist (addresses progressive_disclosure).

Consider noting what to do when the shared skill is absent (e.g., fall back to the description's define/review/repair workflow) to close the fallback gap (addresses actionability).

DimensionReasoningScore

Conciseness

The body is two lines — a provenance comment ("Generated by scripts/agent-harnesses.py; do not edit directly") and a single redirect instruction — with zero padding and no explanation of concepts Claude already knows. Every token serves a purpose, matching the lean score-5 anchor; there is nothing to trim, so score 4 does not apply.

5 / 5

Actionability

"Load and follow the shared skill at `~/.agents/skills/flywheel/SKILL.md`" is a concrete, immediately executable instruction with a specific path, so it clears the mostly-executable score-4 anchor. It falls short of score 5 because all substantive guidance is delegated to an external file with no in-bundle content, no coverage of common cases, and no fallback if that path is absent.

4 / 5

Workflow Clarity

This is a single-task skill and its one action — load and follow the named shared skill file — is unambiguous, which per the simple-skill guideline earns a 5. No destructive or batch operations are involved, so the validation-cap rule is not triggered.

5 / 5

Progressive Disclosure

The single reference to `~/.agents/skills/flywheel/SKILL.md` is clearly signaled and one level deep with nothing inlined that belongs elsewhere, giving good structure. Minor gaps keep it from a 5: the referenced path is external to the bundle and unverifiable from it, and the comment cites `scripts/agent-harnesses.py` although no `scripts/` directory exists in the bundle.

4 / 5

Total

18

/

20

Passed

Description

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

This is a model description: it states comprehensive concrete capabilities in third person and pairs them with an explicit, multi-scenario "Use when" clause full of natural trigger phrases. It compares favorably to the rubric's good overall examples with no padding or over-claiming.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "Define, review, repair, or set up", "records agent sessions", "replaying them on better models", "applies the lessons to instructions, skills, hooks, and memory", "prunes scaffolding", "tunes the loop itself" — giving comprehensive coverage of the skill's capabilities. It matches the score-5 anchor (multiple specific concrete actions) and exceeds score 4, which anticipates gaps in coverage.

5 / 5

Completeness

It explicitly answers "what" (define/review/repair/set up the flywheel learning loop with its record→learn→apply→prune→tune stages) and "when" via an explicit "Use when..." clause with three concrete scenarios. This is the clear score-5 pattern; the when-clause is present and specific, so the score-4 anchor (when could be more explicit) does not fit.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would actually say are well covered: "flywheel", "learning loop", "review or repair", "run retros or evals on recorded sessions", "keep memory", "remove harness scaffolding", plus the concrete file path "docs/flywheel.md". This matches the comprehensive-synonyms anchor; it is above score 4 because both informal terms ("retros") and file-level markers are present.

5 / 5

Distinctiveness Conflict Risk

The agent-harness data flywheel is a clear niche with distinct triggers (flywheel docs, learning loop, retros/evals on recorded sessions, scaffolding pruning), posing minimal conflict risk with other skills. Triggers like "keep memory" are scoped by the surrounding agent-learning context, so the minor-overlap language of the score-4 anchor is not a better fit.

5 / 5

Total

20

/

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

.claude/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.