CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-schema

Manage Basic Memory schemas: find unschemaed notes, infer and edit schemas, validate notes, detect drift. Use when structured note types (Task, Person, Meeting) need consistency across the graph.

Quality

92%

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.

A strong, actionable body: every workflow ships executable bm_* tool calls with full parameters, and the lifecycle (infer → create → validate → fix → diff → evolve) is explicitly sequenced with re-validation feedback loops. The only refinements are trimming redundant restatements in Key Principles and potentially moving the syntax reference to a bundled file.

DimensionReasoningScore

Conciseness

The body is efficient and documents proprietary knowledge (Picoschema syntax, bm_* tool semantics) Claude doesn't already have, but "Key Principles" restates facts the bm_write example already shows ("note_type='schema' marks it as a schema definition", "version: 1 in metadata") and the "Complete Example" recombines the earlier syntax snippets. This matches the 4 anchor ('minor instances of over-explanation that could be trimmed'), not the 5 anchor where every token earns its place.

4 / 5

Actionability

Fully executable, copy-paste-ready calls with complete parameters: bm_schema(command="infer", note_type="Meeting", threshold=0.5, project="<project>"), full bm_write payloads including metadata and content, and complete bm_edit set_metadata examples. Specific examples cover the common cases (infer, create, validate, diff, evolve), matching the 5 anchor.

5 / 5

Workflow Clarity

The Workflow Summary gives a sequenced 6-step lifecycle, and Schema Evolution embeds an explicit feedback loop: "Re-validate to confirm existing notes still pass" followed by "Fix outliers — update notes that don't conform". Clear sequence with explicit validation steps and error recovery matches the 5 anchor, not the 4 anchor which allows validation gaps.

5 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-organized with clear, scannable sections (When to Use, syntax reference, per-task sections, workflow summary). However, the ~100-line Picoschema Syntax Reference is inline reference material that could be split into a separate file — good structure with minor organization gaps matches the 4 anchor rather than the 5 anchor's clean overview-plus-references split.

4 / 5

Total

18

/

20

Passed

Description

92%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.

The description is a model example: it names the target system (Basic Memory) plus four concrete lifecycle actions, and pairs them with an explicit 'Use when...' trigger clause naming real note types. Only minor synonym coverage keeps trigger terms from a perfect score.

DimensionReasoningScore

Specificity

Quotes: "find unschemaed notes, infer and edit schemas, validate notes, detect drift" — four concrete, distinct actions covering the full schema-management lifecycle, matching the 5 anchor ('multiple specific concrete actions; comprehensive coverage'). It exceeds the 4 anchor, which allows minor coverage gaps.

5 / 5

Completeness

Quotes: "Manage Basic Memory schemas: find unschemaed notes, infer and edit schemas, validate notes, detect drift" (explicit what) and "Use when structured note types (Task, Person, Meeting) need consistency across the graph" (explicit when with concrete triggers). Both halves are clearly present, matching the 5 anchor rather than the 4 anchor's weaker 'when'.

5 / 5

Trigger Term Quality

Quotes: "schemas", "validate notes", "detect drift", "structured note types (Task, Person, Meeting)" — good natural keyword coverage a Basic Memory user would say. Not 5: common synonyms/variants like "templates", "frontmatter", or "knowledge base" are missing.

4 / 5

Distinctiveness Conflict Risk

Quotes: "Basic Memory schemas", "detect drift", "Picoschema"-adjacent vocabulary ("structured note types") — a clear niche with distinct triggers that would rarely fire for unrelated skills. Minimal conflict risk matches the 5 anchor.

5 / 5

Total

19

/

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-schema/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.