CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-okf

Make a Basic Memory project ready for OKF v0.2 export by finding and fixing what blocks it. Use when preparing a project for OKF export, publishing, or handoff, or checking an OKF bundle.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 highly actionable, with concrete bm_* tool calls, a blocker-to-fix mapping, and an export/check workflow that includes explicit validation and a fix-and-retry loop. It is lean and well-structured for a single-file skill; the only refinements available are trimming slight repetition and splitting a couple of reference-oriented sections into bundle files.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — the OKF format summary is only what is needed to act, and there is no padding of known concepts. It falls short of level 5 due to minor repetition: the wikilink guidance appears both in the intro and in Guidelines, and the Cloud-task/local-export detail is stated twice.

4 / 5

Actionability

Concrete, copy-paste-ready tool calls with real parameters (bm_find patterns, the bm_search filter, bm_move destinations, bm_write with expected_checksum) plus a blocker-to-fix table and full CLI commands cover the common cases. It clearly exceeds level 4, whose hallmark is 'minor gaps' — placeholders like <project> are explicitly explained rather than left ambiguous.

5 / 5

Workflow Clarity

The three-step process (find blockers, fix via the table, report) is clearly sequenced with explicit validation — bm wiki status reports conflicted pages, bm okf check gives exit codes and per-rule diagnostics — and an explicit feedback loop ('Fix problems in the project and export again'), plus a safety guard on --replace. This matches the level-5 anchor including error-recovery loops, and batch fixes are covered by validation so no cap applies.

5 / 5

Progressive Disclosure

The single SKILL.md (no bundle files exist) is well organized with clear sections — scope, process, local export, what export keeps, guidelines — and navigation is easy. It sits below level 5 because at ~148 lines some self-contained reference material (e.g. 'What Export Keeps', the local export details) could be split into a one-level-deep reference file, and above level 3 since nothing that clearly belongs elsewhere is inlined.

4 / 5

Total

18

/

20

Passed

Description

78%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 with an explicit 'Use when...' clause covering export, publishing, handoff, and bundle checking, anchored in a clearly named domain. Its only weakness is moderate specificity — it summarizes the work as 'finding and fixing what blocks it' without naming the concrete fixes performed.

DimensionReasoningScore

Specificity

The description names the domain ("Basic Memory project", "OKF v0.2 export") and the actions "finding and fixing what blocks it", but stops short of listing the specific fixes it performs. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than level 4, which requires several specific actions.

3 / 5

Completeness

It explicitly answers both what ("Make a Basic Memory project ready for OKF v0.2 export by finding and fixing what blocks it") and when ("Use when preparing a project for OKF export, publishing, or handoff, or checking an OKF bundle") with concrete trigger phrases, matching the level-5 anchor exactly. Level 4 would apply only if the 'when' clause were less explicit.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "OKF export", "publishing", "handoff", "checking an OKF bundle" — giving good keyword coverage for the niche. It falls short of level 5 only because a few natural variants (e.g. "publish to OKF", "validate an OKF bundle") are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (Basic Memory to OKF export) is distinct with domain-specific triggers like "OKF export" and "OKF bundle", so it is unlikely to trigger sibling skills. It sits below level 5 because the generic words "publishing" and "handoff" create minor overlap risk with related memory skills.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

basicmachines-co/basic-memory

Path

skills/memory-okf/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.