CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

checkpoint-mode

Pauses for human review every N tasks (selective autonomy). Use when work needs short autonomous bursts with feedback instead of one long run.

Quality

66%

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 ./examples/agent-skills/checkpoint-mode/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 presents a clear, well-sequenced checkpoint workflow with genuinely useful configuration and summary templates. Its main weaknesses are pseudocode-only agent instructions, padded philosophy/metrics sections that inflate token cost, and a References section pointing to files that do not exist in the bundle.

Suggestions

Replace the pseudocode orchestrator block with executable logic or a real script: define (or link) implementations of load_completed_tasks(), write_signal(), and signal_exists(), and resolve how CHECKPOINT_FREQUENCY is read from LOKI_CHECKPOINT_FREQUENCY.

Trim the Philosophy quote, Problem/Solution bullets, and inline Metrics JSON schema; keep at most a one-line rationale and move metrics tracking details to a reference file.

Fix the References section: either remove the dangling `skills/production.md` entry or ship an actual reference file, and describe each reference specifically so its content is discoverable.

DimensionReasoningScore

Conciseness

Core sections (Configuration, Checkpoint Workflow, Agent Instructions) are tight, but the Philosophy block ("More than 90% of code should be written by agents..." quote, "Problem with Perpetual Autonomy" / "Solution" bullets) and the Metrics JSON schema pad the document without adding executable guidance. This is anchor 3 — mostly efficient with some unnecessary explanation that could be trimmed — rather than 4, since the padding spans multiple sections.

3 / 5

Actionability

Env-var settings, the signal file paths, and the summary markdown template are concrete, but the orchestrator block is pseudocode: `load_completed_tasks()`, `write_signal()`, `signal_exists()`, and `CHECKPOINT_FREQUENCY` are undefined and `completed_tasks` is compared as a variable, not a value. That matches anchor 3 (concrete guidance but incomplete; pseudocode instead of executable) rather than 4 (mostly executable with minor gaps).

3 / 5

Workflow Clarity

The sequence (work N tasks → pause → generate summary → write approval signal → wait → resume on detection) is clearly laid out with explicit checkpoints in both the diagram and numbered "On Checkpoint" steps, and the approval wait is itself a feedback loop. It misses anchor 5 because there is no error-recovery path — nothing specifies what happens when the user rejects or requests changes at a checkpoint.

4 / 5

Progressive Disclosure

The document is well-sectioned, but it is ~170 lines with content that could live in separate files (metrics schema, mode comparison table) inlined, and its only internal reference — `skills/production.md` — is a dangling path with no bundle file behind it, described vaguely as "HN production insights". This matches anchor 3 (some structure, references present but not clearly signaled) rather than 4 (most content appropriately placed, references mostly clear).

3 / 5

Total

13

/

20

Passed

Description

62%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: third-person voice, an explicit what plus a genuine "Use when" clause, and a distinct niche. Weaknesses are thin capability specificity (only one concrete action) and missing natural trigger synonyms such as "checkpoint", "pause", or "approval".

DimensionReasoningScore

Specificity

"Pauses for human review every N tasks" names the domain (agent autonomy management) and one concrete action, but the parenthetical "(selective autonomy)" is abstract and no further concrete capabilities are listed. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several specific actions.

3 / 5

Completeness

The "what" is clear ("Pauses for human review every N tasks") and an explicit "Use when work needs short autonomous bursts with feedback instead of one long run" clause answers "when". It falls short of anchor 5 because the when-clause lacks concrete trigger phrases like "use when the user asks for checkpoints or periodic approval".

4 / 5

Trigger Term Quality

"human review" and "short autonomous bursts with feedback" are natural phrases, but common variations users would say — "checkpoint", "pause", "approval", "supervised" — are absent. Coverage sits at anchor 3 (some relevant keywords, missing common variations), not 4 (good coverage with only a few natural terms missing).

3 / 5

Distinctiveness Conflict Risk

The checkpoint/approval-signal niche is well differentiated from generic work skills, with only minor overlap risk against closely related supervision-mode skills. It is mostly distinct (anchor 4) rather than a clear niche with minimal conflict (anchor 5) because "selective autonomy" language could collide with sibling autonomy-mode skills.

4 / 5

Total

14

/

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

asklokesh/loki-mode

Path

examples/agent-skills/checkpoint-mode/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.