CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-state-tracker

State persistence across autonomous coding sessions. Use when saving progress, loading context, managing feature lists, tracking git history, or restoring session state.

Quality

79%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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, code-first skill body: executable quick start aligned with the real script APIs, a clear three-phase workflow with a verification checkpoint, and a properly split one-level-deep bundle. Weaknesses are modest: an ASCII diagram that wastes tokens, no error-recovery loop around the write-heavy session-end phase, and no usage shown for two of the four scripts.

Suggestions

Replace the ASCII box diagram with a 6-line numbered session checklist — same information, roughly a quarter of the tokens.

Add an explicit validation/feedback step at session end, e.g. 'After updating feature_list.json, re-read it and assert every change is false→true; if not, restore from git and retry', to protect the immutable artifact.

Add one-line usage examples for progress_file.py and git_state.py, since the Scripts section advertises them but Quick Start never shows how to call them.

DimensionReasoningScore

Conciseness

The body is code-first and dense with no explanations of concepts Claude already knows, but the ~20-line ASCII workflow box diagram and the 'Integration Points' section are padding that could be trimmed to a short list. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean 5 anchor.

4 / 5

Actionability

Quick Start provides concrete, near-executable code for the common cases (save_progress with real arguments, load_progress, FeatureList create/update_status), verified against the actual StateTracker/FeatureList APIs in scripts/. It misses 5 because project_dir is used undefined, and two of the four advertised scripts (progress_file.py, git_state.py) get no usage example.

4 / 5

Workflow Clarity

The Workflow section gives a clear three-phase sequence (start: read artifacts + git log; work: select, implement, 'Verify feature passes'; end: update, append, commit) with a verification checkpoint before the state change. It stays at 4 rather than 5 because there is no feedback loop or post-write validation — e.g. what to do when a feature fails verification, or confirming only false→true transitions were written to the 'CATASTROPHIC if deleted' feature_list.json.

4 / 5

Progressive Disclosure

Good structure scored against the actual bundle: both referenced files (references/STATE-ARTIFACTS.md, references/PROGRESS-FORMAT.md) exist, are one level deep with no nested references, and all four listed scripts exist. This matches the 4 anchor's 'a few key examples inline, bulk in separate file' pattern — the full artifact schemas live in the references while trimmed samples are inlined — rather than the leaner quick-start-plus-pointers pattern of the 5 anchor.

4 / 5

Total

16

/

20

Passed

Description

75%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, concrete 'Use when' clause and natural domain trigger phrases. Its main weakness is a thin, abstract 'what' statement — the concrete actions live only in the trigger list — and missing common synonyms/artifact names.

Suggestions

Rewrite the capability statement to name the concrete actions up front, e.g. 'Save and restore session state via a feature list, progress log, and git history. Use when...' — this would lift both specificity and completeness.

Add one or two natural synonyms or artifact names users would say, such as 'resume a session', 'checkpoint progress', or 'feature list / progress file', to broaden trigger coverage without padding.

DimensionReasoningScore

Specificity

The 'when' clause enumerates five concrete actions — "saving progress, loading context, managing feature lists, tracking git history, or restoring session state" — matching the 'several specific actions; minor gaps' anchor, but the headline capability statement "State persistence across autonomous coding sessions" is a single abstract phrase, so it falls short of the comprehensive multi-action 'what' of the 5 anchor.

4 / 5

Completeness

Both parts are present: 'what' ("State persistence across autonomous coding sessions") and an explicit 'when' with concrete trigger phrases. It sits above the 4 anchor's deficiency ('when' could be more explicit — here it is explicit) but below the 5 anchor, whose 'what' lists concrete capabilities rather than one abstract phrase.

4 / 5

Trigger Term Quality

Phrases like "saving progress", "managing feature lists", "tracking git history", and "restoring session state" are natural terms for this domain, giving good keyword coverage. It misses the 5 anchor because common synonyms and artifact names users would say (e.g. 'resume session', 'checkpoint', 'progress file', 'feature_list.json', 'claude-progress.txt') are absent.

4 / 5

Distinctiveness Conflict Risk

The autonomous-coding-session scope carves a clear niche with distinct triggers, giving minimal conflict risk. Minor overlap remains with closely related skills the body itself names (progress-tracker, autonomous-session-manager), keeping it just under the 'clear niche, minimal conflict' 5 anchor.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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