CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loop-nanny

Monitor running agent loops, triage failures, clean up after completion, and decide when to intervene. Use when a loop is running and needs babysitting, when a loop just finished and needs post-merge verification, when stories are skipping/failing and need diagnosis, or when stale test artifacts need cleanup. Triggers on: 'check the loop', 'what happened with the loop', 'loop finished', 'clean up after loop', 'why did that story skip', 'monitor loop', 'nanny the loop', or any post-start loop management task. Distinct from agent-loop skill (which handles starting loops).

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

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.

A strong operational skill body: nearly all guidance is executable joelclaw/git/kubectl commands, workflows are sequenced with explicit verification checkpoints and feedback loops, and risky operations carry caution guards. The only deductions are minor — trimmable prose in the joelclaw-improvement section and inline content that would benefit from being split into reference files.

Suggestions

Trim or relocate the "Improve joelclaw While You Nanny" section: the "What to improve" bullets and source-path commentary could move to a separate reference file or the cli-design skill, leaving a one-line pointer in SKILL.md.

Move the "Common skip causes" and "Diagnosing Stalled Loops" detail tables into a reference file (e.g., references/diagnosis.md) and keep only the diagnostic command and a pointer inline, shortening the always-loaded body.

Tighten the commit-message boilerplate in "How to improve" to a single example line to save tokens without losing clarity.

DimensionReasoningScore

Conciseness

The body is dense and operational (status table, skip-cause table, checklists) with no explanations of concepts Claude already knows, matching the 'efficient' anchor. However, the "Improve joelclaw While You Nanny" section prose and the commit-message boilerplate in "How to improve" could be trimmed, keeping it below the 'every token earns its place' bar.

4 / 5

Actionability

Quotes: `joelclaw loop status <LOOP_ID>`, `grep -i "error\|fail\|reject" /tmp/agent-loop/<LOOP_ID>/*.out`, `kubectl -n joelclaw rollout restart deployment/system-bus-worker`, `joelclaw loop diagnose all -c --fix` — copy-paste ready commands cover the common cases (skip triage, stuck loop, cleanup, worker restart). The one command-free block ("Use the target project's configured test command") is explicitly justified flexibility, so it does not drop the score.

5 / 5

Workflow Clarity

Quotes: the numbered Post-Loop Cleanup steps (1–6) with "Verify merge landed" as an explicit checkpoint, the Monitoring Checklist sequence, intervene/don't-intervene decision criteria, and the diagnose → `--fix` → "Verify fix worked (~30s later)" feedback loop. Destructive operations (cancel, worktree removal, test deletion) carry explicit inspection/preservation guards, matching the top anchor.

5 / 5

Progressive Disclosure

Headers are clear and the two cross-references are one level deep and well signaled ("See [loop-diagnosis skill](../loop-diagnosis/SKILL.md) for full reference", "Follow the [cli-design skill](../cli-design/SKILL.md)"). It stays at 4 rather than 5 because the ~215-line body inlines the tangential "Improve joelclaw While You Nanny" section (and the full skip-cause/diagnosis detail) that would fit better in a separated reference file.

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.

An exemplary description: concrete third-person action list, an explicit 'Use when...' clause with natural trigger phrases including a catch-all, and explicit boundary separation from the sibling agent-loop skill. Every dimension lands on the top anchor.

DimensionReasoningScore

Specificity

Quotes: "Monitor running agent loops, triage failures, clean up after completion, and decide when to intervene" — four concrete actions covering the full lifecycle (monitoring, triage, cleanup, intervention decisions). This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since the actions span every phase of the skill's niche with no obvious gap.

5 / 5

Completeness

Quotes: the action list ("Monitor... triage... clean up... decide when to intervene") answers 'what', and "Use when a loop is running and needs babysitting, when a loop just finished... when stories are skipping/failing... or when stale test artifacts need cleanup" explicitly answers 'when' with concrete trigger phrases. It mirrors the score-5 example structure; the 'when' is explicit, not weakly implied as at 4.

5 / 5

Trigger Term Quality

Quotes: 'check the loop', 'what happened with the loop', 'loop finished', 'clean up after loop', 'why did that story skip', 'monitor loop', 'nanny the loop', "or any post-start loop management task" — these are natural phrases a user would actually say, with synonym variations and a catch-all, matching the comprehensive-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

Quotes: "Distinct from agent-loop skill (which handles starting loops)" — the nearest competing skill is explicitly disambiguated, and the niche (post-start loop management) has distinct triggers. Minimal conflict risk, matching the clear-niche anchor.

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

joelhooks/joelclaw

Path

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