CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-checkpoint

Save a deliberate work checkpoint to Basic Memory with the story, changed files, verification, decisions, blockers, and the next action. Use when the user asks to checkpoint, wrap up, hand off, or remember the state of the work.

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

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, high-signal instructional skill: every step is concrete, non-obvious project rules (config precedence, session-identity, typed PR fields) are captured compactly, and validation guards are explicit. The main residual gaps are the absence of a worked note example and a slightly dense single-file layout.

Suggestions

Add one short worked example of a finished checkpoint note body (sections plus `[next_step]`/`[decision]` observation lines) so the observation format is copy-paste unambiguous.

Trim the opening paragraph's restatement of the description's trigger conditions to save tokens without losing guidance.

Consider moving the coding-profile field schema and config-precedence rules into a single one-level-deep reference file, keeping SKILL.md as a leaner overview.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes competence — e.g. "Apply the `bm-writing` skill before drafting the note" and "Begin the body with `# <exact note title>`" — with no explanation of concepts Claude already knows. Minor trim opportunities remain: the opening paragraph re-states the description's trigger conditions, and the config-precedence paragraph is wordier than strictly needed.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact commands (`git status --short`, `gh pr view --json ...`), a complete field schema (`note_type: session`, `tags: ["claude", "checkpoint"]`, `pull_request_number: "123"`), a section template, and one relation example (`- relates_to [[Exact existing note title]]`). Minor gaps: no worked example of a full note body and no example line showing the observation format (e.g. `[next_step] ...`), so it is mostly rather than fully executable.

4 / 5

Workflow Clarity

A clear Gather -> Write -> Confirm sequence with explicit validation guards ("Do not claim a test passed unless you ran it", "Stop if the required coding fields cannot be proven", "never infer one" for session IDs) and a checklist of evidence to gather. It stops short of anchor 5 because there is no post-write verification or error-recovery loop (e.g. handling a failed `write_note` call), though the operation is not destructive or batch.

4 / 5

Progressive Disclosure

No bundle files exist, and the single file is well organized under `## Gather`, `## Write`, `## Confirm` with clearly signaled field lists per profile. It is not anchor 5 because at ~127 lines the coding-profile field schema and config-precedence rules are borderline content that could live in a one-level-deep reference file, but nothing is buried or nested.

4 / 5

Total

16

/

20

Passed

Description

88%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 strong description: it states exactly what is saved (and to where), gives explicit natural-language triggers, and stays concise in third-person imperative voice. Only minor headroom exists around trigger synonym coverage and slight overlap risk with generic wrap-up/note skills.

DimensionReasoningScore

Specificity

"Save a deliberate work checkpoint to Basic Memory with the story, changed files, verification, decisions, blockers, and the next action" enumerates multiple specific concrete artifacts of the action — comprehensive within the skill's scope, matching the anchor-5 good example style. Nothing is vague or generic, so it is not anchor 4 (which requires minor coverage gaps).

5 / 5

Completeness

Both halves are explicit: the what is "Save a deliberate work checkpoint to Basic Memory with the story, changed files, verification, decisions, blockers, and the next action" and the when is "Use when the user asks to checkpoint, wrap up, hand off, or remember the state of the work" — an exact match for the anchor-5 good example with concrete trigger phrases. Anchor 4 would require a weaker or less explicit 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

"checkpoint, wrap up, hand off, or remember the state of the work" covers natural phrases users would say, and "Basic Memory" names the target system. It sits at anchor 4 rather than 5 because common synonyms like "save my progress", "session summary", or "pause/stop for today" are missing.

4 / 5

Distinctiveness Conflict Risk

The Basic Memory target and "deliberate work checkpoint" framing carve a clear niche with distinct triggers. It is not anchor 5 because broad triggers like "wrap up" and "remember the state of the work" could also plausibly fire for general note-taking or session-summary skills.

4 / 5

Total

18

/

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
basicmachines-co/basic-memory
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.