CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

progress-tracker

Track and report progress across autonomous coding sessions. Use when generating progress reports, calculating metrics, visualizing completion, or estimating time to completion.

Quality

80%

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

Quality

Content

71%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 lean and immediately actionable, with copy-paste Quick Start code and a clear overview that points to bundle files. Its main defects are a dangling reference to `references/REPORT-FORMATS.md` (the file does not exist) and missing setup details such as what `project_dir` must contain and how the four scripts are invoked.

Suggestions

Create `references/REPORT-FORMATS.md` or remove the reference — the link currently points to a file that is not in the bundle.

Add a short setup note (or a line in Quick Start) describing the expected `project_dir` layout and the progress-file format the tracker reads.

Clarify the role of the four scripts (e.g., whether `progress_tracker.py` is the sole entry point and the others are internal) and trim the full ASCII dashboard to a compact excerpt to tighten token use.

DimensionReasoningScore

Conciseness

The body is efficient: it opens with runnable snippets, shows an example dashboard as output rather than explaining concepts, and uses tables for metrics — no padding or explanations of things Claude already knows. It falls short of the 5 anchor because the full-width ASCII dashboard block is largely decorative example output that could be trimmed to a few lines, matching the 4 anchor's 'minor instances that could be trimmed'.

4 / 5

Actionability

Quick Start provides concrete, executable code (`tracker.get_progress()`, `tracker.generate_report(format="markdown")`, `tracker.visualize_progress()`) with expected output. It sits at the 4 anchor rather than 5 because key details are missing: how `project_dir` must be structured, where the progress file lives, and how the four listed scripts relate to the ProgressTracker class are left unspecified.

4 / 5

Workflow Clarity

Usage is unambiguous for a simple skill — instantiate `ProgressTracker(project_dir)` and call a named method per task — so the simple-skill exception applies upward, and no validation is needed since operations are read-only. It does not reach 5 because the body never sequences the operations or explains how to go from a raw project directory to a report (which script to invoke, what prerequisites the data must satisfy), leaving a minor gap between the quick-start snippets and the Metrics/Scripts sections.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the body is a clean overview with clearly labeled sections, and `references/METRICS.md` plus all four `scripts/*.py` resolve, but the referenced `references/REPORT-FORMATS.md` does not exist in the bundle, so navigation for that path fails. This places it between anchor 3 ('could be better organized', broken/unsatisfiable reference) and anchor 4 ('references mostly clear; minor organization gaps'); the dangling reference is a concrete navigational defect rather than a tidy organization nit, so 3 is the best fit.

3 / 5

Total

15

/

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 in third person with a clear what-statement and an explicit, trigger-rich Use-when clause covering four concrete capabilities. Its only weaknesses are minor: some natural synonyms (status, ETA, velocity) are absent and output specifics are not named.

Suggestions

Add common user phrasings like "ETA", "completion status", or "how much is left" to the Use-when clause to broaden trigger coverage.

Mention the concrete outputs (markdown reports, ASCII progress bars, per-category breakdowns) to sharpen the what-statement and further distinguish from generic reporting skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Track and report progress", "generating progress reports, calculating metrics, visualizing completion, or estimating time to completion" — matching the anchor for several specific actions with minor gaps (no mention of per-category breakdown or dashboard output). It is above the 'names domain and 1-2 concrete actions' anchor (3) because coverage spans four distinct capabilities, but short of comprehensive (5) since output formats and metric types are unnamed.

4 / 5

Completeness

It explicitly answers both parts: what ("Track and report progress across autonomous coding sessions") and when ("Use when generating progress reports, calculating metrics, visualizing completion, or estimating time to completion") with four concrete trigger phrases. This mirrors the 5 anchor's structure; the 4 anchor ('when could be more explicit') does not apply since the when-clause is explicit and enumerates triggers.

5 / 5

Trigger Term Quality

Natural phrases like "progress reports", "calculating metrics", "visualizing completion", and "estimating time to completion" map well onto what a user would say, giving good keyword coverage. It falls short of the 5 anchor because common synonyms such as "status", "ETA", "completion percentage", or "velocity" are missing, but it is clearly above 'some relevant keywords, missing common variations' (3).

4 / 5

Distinctiveness Conflict Risk

The niche of "autonomous coding sessions" progress tracking with metrics/visualization/ETA triggers is mostly distinct with only minor overlap risk against general reporting or dashboard skills. It lacks the fully distinct trigger set of the 5 anchor but is far more specific than the 'somewhat specific but could overlap' anchor (3).

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/progress-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.