CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-checkpoint-manager

Manage checkpoints for rollback capability. Use when creating save points, rolling back changes, managing recovery points, or restoring previous states.

60

Quality

76%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 compact, well-structured skill with a verified executable Quick Start and clean one-level-deep reference to its implementation script. The weakest area is the Workflow section, which names validation steps but provides no concrete commands or error-recovery path for the destructive restore operation.

Suggestions

Add a feedback loop to the Workflow section, e.g. 'If validation fails: review the error, fix the checkpoint, re-validate — only restore when validation passes.'

Make the workflow steps executable by attaching commands or API calls to each step (e.g. how to validate integrity and confirm restoration with CheckpointManager).

Trim the redundant Purpose section, which restates the description, and use a concrete project_dir value or explain how to obtain it in the Quick Start.

DimensionReasoningScore

Conciseness

The body is lean with useful sections (Quick Start, Checkpoint Types, Structure, Workflow) and no padding aimed at concepts Claude already knows. The 'Purpose' section ('Creates and manages checkpoints that enable rollback to known-good states...') largely repeats the title and description and could be trimmed, matching anchor 4 ('efficient; minor instances that could be trimmed') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

The Quick Start is real, executable code — 'from scripts.checkpoint_manager import CheckpointManager', 'await manager.create_checkpoint("before-refactor")', 'await manager.restore_checkpoint(checkpoint.id)' — verified against the actual bundle script. It stays at anchor 4 rather than 5 because 'project_dir' is an undefined placeholder, there's no example of error handling or listing checkpoints, and only the happy path is shown.

4 / 5

Workflow Clarity

The Workflow section lists a clear sequence (CREATE → STORE → VALIDATE → RESTORE → VERIFY), but the steps are abstract labels with no commands and no feedback loop (validate → fix → retry) for what is a destructive restore operation. Per the rubric's scoring notes, missing feedback loops on destructive changes cap workflow_clarity at 3; it is not lower because the sequence itself is coherent and validation/verification steps are explicitly named.

3 / 5

Progressive Disclosure

The body is a short, well-organized overview that keeps the full implementation in the bundle file, clearly signaled one level deep: 'See scripts/checkpoint_manager.py for full implementation' — and that file actually exists with the referenced class and methods. Content is appropriately split with easy navigation, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Description

70%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 solid description with an explicit 'Use when' trigger clause and good natural keyword coverage. Its main weakness is that the enumerated actions are near-synonyms of rollback rather than a fuller inventory of what the skill actually does.

Suggestions

Replace the synonym-heavy trigger list with distinct concrete capabilities, e.g. 'Create checkpoints that snapshot project state and git refs, restore checkpoints to roll back to a known-good state, and validate checkpoint integrity.'

Add one or two natural trigger synonyms such as 'snapshots' or 'backups' to widen the natural-phrase coverage.

State what a checkpoint actually captures (files, git ref, execution state) to strengthen the 'what' half of the description.

DimensionReasoningScore

Specificity

The description names the domain ('Manage checkpoints for rollback capability') plus 1-2 concrete actions (creating save points, restoring previous states), but the action list ('rolling back changes, managing recovery points, or restoring previous states') is largely synonyms of one capability rather than several distinct actions. It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'), not anchor 4's 'several specific actions' with only minor gaps.

3 / 5

Completeness

It answers both 'what' ('Manage checkpoints for rollback capability') and 'when' ('Use when creating save points, rolling back changes...') with concrete trigger phrases. The 'what' clause is a single thin statement that doesn't convey what a checkpoint contains or does, so it fits anchor 4 ('when' could be more explicit/the what could be fuller) rather than anchor 5's clearly comprehensive both.

4 / 5

Trigger Term Quality

Natural phrases like 'save points', 'rolling back changes', 'recovery points', and 'restoring previous states' give good keyword coverage a user would plausibly say. It falls short of anchor 5 because common synonyms such as 'snapshots', 'backups', or 'undo' are missing.

4 / 5

Distinctiveness Conflict Risk

Checkpoint/rollback management is a clear niche with distinct trigger terms, so it is mostly distinguishable from unrelated skills. There is minor overlap risk with generic version-control, backup, or git-restore skills, matching anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
fernandezbaptiste/Skrillz
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.