CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-state-tracker

State persistence for autonomous coding. Use when saving progress, loading state, tracking features, managing checkpoints, or persisting data across sessions.

Quality

78%

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-state-tracker/SKILL.md

The canonical home for this skill is ac-state-tracker in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 well-structured API reference whose code examples are fully executable and match the bundled state_tracker.py implementation. The main weaknesses are duplicated quick-start/operations content, schemas inlined despite a (nonexistent) schema reference file, four missing referenced bundle files, and no validation steps around the destructive checkpoint-restore operation.

Suggestions

Remove the duplicated save/load/update examples from Quick Start (they repeat Operations 1-2 verbatim) and move the three full JSON schemas and progress-file sample into references/STATE-SCHEMA.md, keeping only a brief field summary inline.

Add validation around destructive and batch operations: verify a checkpoint exists before restore_checkpoint, and confirm feature_list.json state after restore before proceeding.

Create the missing referenced files (references/STATE-SCHEMA.md, references/FEATURE-LIFECYCLE.md, scripts/feature_manager.py, scripts/checkpoint_store.py, scripts/progress_logger.py) or remove their entries from the References and Scripts sections so navigation matches the actual bundle.

DimensionReasoningScore

Conciseness

The body is mostly efficient API documentation with little concept-explaining padding, but it could be tightened: the "Quick Start" section ("await state.initialize()", "await state.save()", "await state.update_feature(...)") duplicates the Operations section almost verbatim, and ~90 lines of full JSON schemas plus a full sample progress file are inlined even though "references/STATE-SCHEMA.md - Complete state schemas" is cited for the same material. This fits the level-3 anchor (mostly efficient, some tightening possible) rather than level 2, since there is no explanation of concepts Claude already knows.

3 / 5

Actionability

Every operation ships copy-paste-ready code ("await state.update_feature(feature_id='auth-001', passes=True, actual_effort='2.5h')", "await state.create_checkpoint(name='before-refactor', git_commit=True)") that matches the actual scripts/state_tracker.py signatures exactly (update_feature, create_checkpoint, log_activity, save_handoff, get_progress all verified), and the seven documented operations cover the common cases — matching the level-5 anchor.

5 / 5

Workflow Clarity

Operations are individually clear and numbered, but there is no end-to-end usage sequence, and the destructive restore operation ("await state.restore_checkpoint(...) # Restores feature_list.json and git state") has no validation or verification step — no check that the checkpoint exists or that state was restored correctly. Per the judging guidelines, missing validation on destructive operations caps workflow clarity at 3 even though the per-operation steps are otherwise well presented.

3 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled ("references/STATE-SCHEMA.md - Complete state schemas", "scripts/state_tracker.py - Core StateTracker class"), but scored against the actual bundle: 4 of the 6 referenced files do not exist (no references/ directory; only scripts/state_tracker.py is present while feature_manager.py, checkpoint_store.py, and progress_logger.py are missing), and the schema content that belongs in STATE-SCHEMA.md is instead inlined in the body. This lands at level 3 (some structure, could be better organized) rather than 2 because the navigation sections themselves are clear and well organized.

3 / 5

Total

14

/

20

Passed

Description

83%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 an explicit 'Use when...' clause listing concrete trigger phrases and a clearly stated domain. Trigger coverage is good but could add synonyms and file-level terms for full comprehensiveness.

DimensionReasoningScore

Specificity

The description lists several specific actions within its domain — "saving progress, loading state, tracking features, managing checkpoints, or persisting data across sessions" — which is several concrete actions with minor gaps in coverage, matching the level-4 anchor. It falls short of level 5 because the verbs are generic (saving, loading, managing) compared to the fully concrete action set in the level-5 example, and above level 3 since more than 1-2 actions are named.

4 / 5

Completeness

It explicitly answers both questions: the what is "State persistence for autonomous coding" and the when is an explicit "Use when saving progress, loading state, tracking features, managing checkpoints, or persisting data across sessions" with concrete trigger phrases, matching the level-5 anchor. The 'Use when...' clause is present, so the completeness cap of 3 does not apply.

5 / 5

Trigger Term Quality

Natural phrases like "saving progress", "loading state", "managing checkpoints", and "track... features" map to what a user would plausibly say when needing this skill, giving good keyword coverage per the level-4 anchor. It is not level 5 because it lacks synonyms and file-level triggers (e.g., feature_list.json, state files, rollback, resume session) that would give comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The domain qualifier "for autonomous coding" plus checkpoint/feature-tracking triggers give it a clear niche with mostly distinct triggers (level 4). It is not level 5 because "saving progress" and "persisting data across sessions" carry minor overlap risk with closely related session/handoff skills; it is well above level 3 since the trigger set is not generic.

4 / 5

Total

17

/

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: 5 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/ac-state-tracker/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.