CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

checkpoint-manager

State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation.

Quality

73%

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 ./.claude/skills/checkpoint-manager/SKILL.md

The canonical home for this skill is checkpoint-manager in fernandezbaptiste/Skrillz

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 opens with genuinely useful Quick Start code and a concrete checkpoint schema, but it spends ~25 lines on a decorative ASCII workflow that adds no information, omits validation steps around its destructive rollback flow, and points readers at two reference files missing from the bundle. Structure and signal are decent; correctness of the references and token efficiency are the weak points.

Suggestions

Replace the ASCII workflow box with a compact numbered list or short sequence description — it restates the Quick Start in ~25 lines of box-drawing characters.

Add validation/verification steps around the destructive rollback flow (e.g., verify checkpoint integrity before `git reset`, verify restored state after rollback) to lift workflow clarity past the destructive-operation cap.

Fix the dangling references: either add `references/CHECKPOINT-STRATEGY.md` and `references/ROLLBACK-PROCEDURES.md` to the bundle or remove them from the References section, since both paths currently resolve to nothing.

DimensionReasoningScore

Conciseness

The prose is lean and doesn't explain concepts Claude already knows, but the ~25-line ASCII box diagram ("CHECKPOINT WORKFLOW") purely restates the create/rollback steps in decorative box-drawing characters — a substantial block that could be a five-line list. That is more than the 'minor instances' of anchor 4, fitting anchor 3 ('mostly efficient but... could be tightened').

3 / 5

Actionability

The Quick Start gives concrete, mostly executable code — `manager = CheckpointManager(project_dir)`, `await manager.create_checkpoint(...)`, `await manager.rollback(checkpoint.id)` — plus a concrete checkpoint JSON schema. Minor gaps remain: `project_dir` is never defined or sourced, and the four listed scripts get only one-line descriptions with no invocation examples. Not anchor 5 ('copy-paste ready, covers common cases') because of those gaps; better than anchor 3's pseudocode.

4 / 5

Workflow Clarity

The create → risky operation → rollback sequence is clear, including a failure branch, but the workflow involves destructive operations (git reset, restoring state) with no validation or verification steps — no check that the checkpoint is intact before reset, no verification that rollback succeeded. Per the rubric's guideline, missing validation in destructive workflows caps this at 3, which the clear sequence otherwise supports.

3 / 5

Progressive Disclosure

Structure is good on paper — a References section with one-level-deep pointers and a Scripts section — but both referenced files (`references/CHECKPOINT-STRATEGY.md`, `references/ROLLBACK-PROCEDURES.md`) do not exist in the bundle; the pointers are clearly signaled yet broken, so navigation fails. This sits between anchor 2's misplacement/buried references and anchor 4's appropriately placed, working references.

3 / 5

Total

13

/

20

Passed

Description

78%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 well-formed description with a clear what, an explicit multi-trigger "Use when" clause, and natural keywords. Its main weaknesses are a thin capability list (only two actions) and missing common synonyms like revert/undo/restore that would strengthen triggering.

Suggestions

Expand the capability list beyond 'State snapshots and rollback' to cover the concrete operations the skill performs (e.g., 'Create, restore, and prune state checkpoints').

Add natural synonym triggers such as 'revert', 'undo changes', or 'restore state' to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "State snapshots and rollback" — but stops there; it doesn't enumerate the fuller capability set (create, restore, prune checkpoints). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4, which expects several listed specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: the "what" ("State snapshots and rollback for safe experimentation") and an explicit "Use when..." clause with four concrete trigger phrases. This mirrors anchor 5's model example structurally; it is not anchor 4 because the "when" is already explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "creating checkpoints", "rolling back changes", "managing recovery points" — which users would plausibly say. Common synonyms like "revert", "undo", "restore", or "save state" are missing, matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The checkpoint/rollback/recovery-point niche is mostly distinct with clear triggers, but there is minor overlap risk with closely related skills (git versioning, backup, or undo-type skills). Anchor 4 ('mostly distinct; minor overlap risk') fits better than anchor 5, since terms like "rollback" and "snapshots" are shared vocabulary with those adjacent domains.

4 / 5

Total

16

/

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

fernandezbaptiste/Skrillz

Path

.claude/skills/checkpoint-manager/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.