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

68%

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 ./skills/ac-state-tracker/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 is actionable with a verified, executable API, but it has structural problems: a Quick Start/Operations duplication, inline schemas that should live in the referenced schema file, no validation around destructive checkpoint restores, and five dangling bundle references that break navigation.

Suggestions

Fix the dangling references: either create references/STATE-SCHEMA.md and references/FEATURE-LIFECYCLE.md and scripts/feature_manager.py, scripts/checkpoint_store.py, scripts/progress_logger.py, or update the References/Scripts lists to reflect the actual bundle (all functionality currently lives in scripts/state_tracker.py).

Move the three full JSON schemas and the claude-progress.txt format out of SKILL.md into references/STATE-SCHEMA.md, keeping only a brief field summary inline, and merge the Quick Start into the Operations section to remove the duplicated initialize/save/load examples.

Add validation steps around destructive operations, e.g., verify feature_list.json after restore_checkpoint and show the error path when update_feature attempts an illegal passes transition (true to false) or a missing feature ID.

DimensionReasoningScore

Conciseness

The body avoids concept over-explanation, but the Quick Start section duplicates Operations 1-3 (initialize, save/load, and update_feature appear twice with near-identical code), and roughly 85 lines of JSON schemas plus the progress-file format are inlined even though the References section claims complete schemas live in references/STATE-SCHEMA.md. Mostly efficient but could be tightened, matching anchor 3.

3 / 5

Actionability

Operations 1-7 are concrete, copy-paste-ready API calls with real parameters and documented return values, and they match the actual scripts/state_tracker.py implementation. Minor gaps keep it below anchor 5: no error-path examples (e.g., what happens on an illegal passes transition or missing feature) and the 'from scripts.state_tracker import' path is assumed without setup guidance.

4 / 5

Workflow Clarity

The seven operations are individually listed with a rough Quick Start sequence, but validation is absent throughout: restore_checkpoint destructively overwrites feature_list.json and git state with no verify step, and there is no feedback loop for failed updates. Per the rubric's cap, missing validation around destructive operations holds this at anchor 3.

3 / 5

Progressive Disclosure

Judged against the actual bundle: sections are well-organized and the References/Scripts lists are clearly signaled, but 5 of the 6 referenced bundle files do not exist (references/STATE-SCHEMA.md, references/FEATURE-LIFECYCLE.md, scripts/feature_manager.py, scripts/checkpoint_store.py, scripts/progress_logger.py), and the full schema content that clearly belongs in a separate file is inlined in SKILL.md, matching anchor 2.

2 / 5

Total

12

/

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 and natural trigger clause, held back by an abstract 'what' clause and generic action objects. Trigger coverage is good but lacks synonyms like 'resume session' or 'restore checkpoint'.

Suggestions

Replace the abstract 'what' with enumerated concrete capabilities, e.g. 'Tracks feature pass/fail status, execution state, progress logs, handoff packages, and rollback checkpoints in JSON files across sessions.'

Add natural trigger synonyms such as 'resume session', 'restore checkpoint', 'handoff', or 'feature status' to broaden when-clause coverage.

Drop the redundant 'persisting data across sessions' phrase, which duplicates 'state persistence' without adding a trigger.

DimensionReasoningScore

Specificity

The description names its domain ('State persistence for autonomous coding') and lists several action gerunds ('saving progress, loading state, tracking features, managing checkpoints'), but the actions operate on vague objects ('state', 'progress', 'data') and 'persisting data' merely restates the opening, falling short of anchor 4's concrete verb-and-object specificity.

3 / 5

Completeness

It has both a 'what' ('State persistence for autonomous coding') and an explicit 'Use when...' clause with concrete trigger phrases, satisfying anchor 4; the 'what' is a single abstract noun phrase rather than an enumerated capability list, so it does not clearly meet anchor 5.

4 / 5

Trigger Term Quality

The 'Use when' clause contains natural phrases users would say ('saving progress, loading state, tracking features, managing checkpoints'), matching anchor 4's good coverage; it misses common synonyms such as 'resume session', 'restore checkpoint', or 'handoff', so it does not reach anchor 5.

4 / 5

Distinctiveness Conflict Risk

The 'autonomous coding' scope combined with feature-tracking and checkpoint vocabulary carves a mostly distinct niche with minor overlap risk against generic persistence or git checkpoint skills, fitting anchor 4.

4 / 5

Total

15

/

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

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.