CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-session-capture-backup

Verify, repair, backfill, and back up Pi/Claude/Codex session capture across active machines. Use when checking whether agent activity is captured, reviewing capture outbox backlogs, backing transcripts up to NAS, or scheduling capture verification.

69

Quality

87%

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 lean, high-signal operational skill: executable commands, explicit mutation-authorization boundaries, and a real validation checklist in the Green criteria. The main weaknesses are satellite/replay guidance that never becomes concrete and repeated deferrals to an out-of-bundle 'private operator map', plus the absence of an explicit failure-recovery loop.

Suggestions

Add one concrete satellite example (sample --hosts list and an approved Central URL form) and a minimal replay-capture-outbox.ts invocation with its bounding flags, so all code paths are copy-paste ready.

Add a short 'when a check fails' recovery step to the Green criteria (e.g., unreachable host or failed source sync: re-run verification for that host, write a receipt, do not mark green), closing the feedback-loop gap.

Reduce the four 'see the private operator map' deferrals by either bundling a sanitized operator-map reference file with the current paths or consolidating the pointer into a single clearly-signaled 'External references' section.

DimensionReasoningScore

Conciseness

The body is dense with non-derivable operational facts (specific paths, flags, cron spec, mutation boundaries) and assumes Claude's competence throughout — no concept explanations, no padding. Lines like "Counts and preserved mtimes alone do not prove parity; partial rsync is not verified completion" carry maximum information per token. Not the 4 anchor because there is no over-explanation to trim; the Panda mention in Gotchas adds authorization-relevant safety value rather than repetition.

5 / 5

Actionability

The core audit command is fully executable with all flags (--hosts, --central-url, --backup-root, --sync=false), and the manual trigger includes a copy-paste-ready joelclaw send payload. Falls short of 5 because satellite runs get only abstract guidance ("select active hosts and an approved Central URL"), replay has no invocation example, and several concrete paths are deferred to an unavailable "private operator map". Clearly above the 3 anchor's pseudocode/incomplete level.

4 / 5

Workflow Clarity

The audit script's behavior is enumerated as an explicit five-step sequence, and the Green criteria section acts as a strong validation checklist (receipts, centralHealthOk, outbox/hash/index reconciliation) for a batch operation. Validation is present, so the destructive/batch cap at 3 does not apply. Not 5: there is no explicit error-recovery loop (e.g., what to do when a host is unreachable or a source sync fails — only 'remains unverified'), leaving a minor feedback-loop gap.

4 / 5

Progressive Disclosure

The body is well-sectioned (Canonical surfaces, Manual verification, Durable scheduled workflow, Green criteria, Gotchas) with no bundle files needed for its size (~90 lines). Not 5: the repeated "see the private operator map" pointers (four times) reference a document that is not part of the skill bundle, and the green-criteria/receipt detail plus gotchas could arguably live in reference files. Comfortably above the 3 anchor's 'structure but could be better organized'.

4 / 5

Total

17

/

20

Passed

Description

88%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: concrete action verbs, a named multi-runtime domain, and an explicit multi-scenario 'Use when' trigger clause. Third person voice is correct throughout. Trigger coverage is solid though not exhaustive of every synonym a user might say.

DimensionReasoningScore

Specificity

Lists four concrete, distinct actions ("Verify, repair, backfill, and back up") against a named domain ("Pi/Claude/Codex session capture across active machines"), giving comprehensive coverage of the skill's operations. It matches the 'multiple specific concrete actions; comprehensive coverage' anchor rather than the 4 anchor, which implies noticeable gaps in action coverage.

5 / 5

Completeness

Explicitly answers 'what' (verify, repair, backfill, back up session capture) and 'when' with a concrete "Use when..." clause enumerating four trigger scenarios. This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; the 4 anchor would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

Natural user phrasings are present ("checking whether agent activity is captured", "reviewing capture outbox backlogs", "backing transcripts up to NAS", "scheduling capture verification"), matching the good-coverage anchor. Not a 5: a few plausible synonyms (e.g., 'session logs', 'transcript sync', 'backup health') are missing, but it is clearly above the 'some relevant keywords' level of 3.

4 / 5

Distinctiveness Conflict Risk

The domain (agent session capture, outbox backlogs, NAS transcript backup) is a clear niche with distinct triggers, but terms like 'back up' and 'captured' are broad enough to mildly overlap with generic backup/sync skills. Mostly distinct with minor overlap risk — the 4 anchor — rather than the minimal-conflict 5.

4 / 5

Total

18

/

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
joelhooks/joelclaw
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.