memory-schema

Schema lifecycle management for Basic Memory: discover unschemaed notes, infer schemas, create and edit schema definitions, validate notes, and detect drift. Use when working with structured note types (Task, Person, Meeting, etc.) to maintain consistency across the knowledge graph.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

95%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 high-quality, actionable skill body with executable examples, well-sequenced workflows that include validation feedback loops, and clean section organization. The main improvement area is conciseness — a few explanatory and principle-list lines echo what the code already demonstrates.

Suggestions

Trim lines that restate what the code shows, e.g. 'making notes uniform, queryable, and validatable' and the 'Key Principles'/'Evolution Guidelines' bullets that duplicate the schema_infer/write_note examples.

The 'Validation Settings' note about 'error is accepted only as a compatibility alias' is compatibility detail; consider whether it earns its tokens or could move to a deprecation note.

If the skill grows, split the Picoschema Syntax Reference and the per-operation examples into referenced files so SKILL.md stays a lean overview.

Dimension	Reasoning	Score
Conciseness	Mostly lean and assumes Claude's competence (no padding about what YAML or schemas are), but a few lines like 'making notes uniform, queryable, and validatable' and the bulleted Key/Evolution Principles restate points already shown in code, so it is not fully stripped.	4 / 5
Actionability	Provides concrete, copy-paste-ready calls — schema_infer, write_note, schema_validate, schema_diff, edit_note — each with realistic kwargs and arguments covering the common cases.	5 / 5
Workflow Clarity	Multi-step processes (Discovering, Creating, Evolution) are clearly sequenced with explicit validation checkpoints and a feedback loop ('Re-validate to confirm existing notes still pass' then 'Fix outliers'), plus a full Workflow Summary.	5 / 5
Progressive Disclosure	Well-organized into clear sections with no nested or buried references, but it is a single ~240-line file with no external reference files; structure is good yet slightly above the simple-skill threshold where a 5 would apply.	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.

A strong, specific description that names concrete lifecycle actions and gives an explicit use-when clause tied to natural trigger terms. Its only weakness is that trigger terms lean on Basic Memory's internal vocabulary rather than the plain words a user might say.

Dimension	Reasoning	Score
Specificity	Enumerates multiple concrete actions — 'discover unschemaed notes, infer schemas, create and edit schema definitions, validate notes, and detect drift' — covering the full schema lifecycle comprehensively, matching the 5 anchor.	5 / 5
Completeness	Clearly states what it does ('Schema lifecycle management...') with enumerated actions and an explicit 'Use when working with structured note types...' trigger clause, satisfying both what and when.	5 / 5
Trigger Term Quality	Includes natural triggers like 'structured note types (Task, Person, Meeting, etc.)', 'schema', and 'drift', but relies on Basic Memory's domain jargon and lacks common user-said synonyms; fits just above the midpoint rather than fully comprehensive.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche — Basic Memory Picoschema schema management — with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: a5fb68e

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.