CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-onboarding

Guide someone new to Basic Memory through designing and building a complete personal knowledge system — interview them about what they want to track, propose a structure, build it with schemas and instruction notes, teach them to use it, and set up their AI assistant to load it automatically. Use this skill whenever a user says they're new to Basic Memory, wants to 'get started', 'set up', or 'onboard' with Basic Memory, doesn't know what to use it for, asks how to organize their memory project or knowledge base, wants help designing folders/schemas/conventions, or asks how to make their assistant remember context between sessions. Also use it when a user has an empty or messy Basic Memory project and wants structure.

77

Quality

96%

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

92%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, actionable onboarding skill: it sequences a multi-phase workflow with explicit approval gates and validation feedback loops, delegates syntax/router anatomy to four real one-level-deep reference files, and names the concrete tools and doc URLs needed to execute. The only soft spot is a handful of motivational sentences that pad the otherwise tight guidance.

Suggestions

Trim rhetorical/motivational lines (e.g. 'A small system that works grows; a sprawling empty scaffold dies', 'Building the wrong structure is worse than building nothing — the user will have to unlearn it') to their actionable core so 'Why this approach' reads as rules, not persuasion.

The 'Speak Plainly' section restates its thesis several times; condense to the plain-word definitions plus the 'user never writes syntax' rule and the one-concept-at-a-time heuristic.

DimensionReasoningScore

Conciseness

Largely efficient and purposeful — it establishes non-negotiables, gives concrete heuristics, and names specific tools rather than explaining Basic-Memory concepts Claude could infer — but sections like 'Why this approach' and motivational lines ('A small system that works grows; a sprawling empty scaffold dies') could be trimmed. Not a 5: a few sentences are rhetorical padding rather than actionable guidance; not a 3: the bulk is tight and skill-specific.

4 / 5

Actionability

Highly actionable for an instruction-only skill: it names concrete MCP tools (write_note, schema_validate, list_memory_projects, build_context, edit_note), exact doc URLs (https://docs.basicmemory.com/llms.txt, raw/reference/mcp-tools-reference.md), the reference file to read at each phase, and concrete interview prompts/seed-note examples. Not a 4: the common cases are fully covered with specific, executable direction rather than minor gaps.

5 / 5

Workflow Clarity

Seven phases (0–6) are explicitly sequenced with an approval gate between Phase 2 and 3, validation in Phase 3 step 7 ('run schema_validate... fix anything it flags'), a read-back link check, and a Phase 4 verification test — a clear feedback loop for the batch/migrating operations. Not a 4: validation checkpoints and error-recovery loops are explicit and complete, satisfying the destructive/batch cap.

5 / 5

Progressive Disclosure

SKILL.md is an overview that signals one-level-deep references via a 'Reference files' table and inline 'Read references/X.md' cues at each phase; all four referenced files (conventions.md, schema-guide.md, domain-playbooks.md, assistant-setup.md) exist in ./references/. Not a 4: navigation is explicit and every reference resolves to a real file with no nesting.

5 / 5

Total

19

/

20

Passed

Description

100%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, complete description: it states concrete capabilities, gives explicit and comprehensive trigger phrasings for when to use the skill, and scopes itself to a clear Basic-Memory-onboarding niche with low conflict risk. Third-person voice is maintained throughout with no over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'interview them about what they want to track, propose a structure, build it with schemas and instruction notes, teach them to use it, and set up their AI assistant to load it automatically' — giving comprehensive coverage of the skill's capabilities. Not a 4: it enumerates five distinct concrete actions rather than leaving minor gaps.

5 / 5

Completeness

Explicitly answers both 'what' (the full design/build/teach/wire-in sequence) and 'when' via 'Use this skill whenever...' and 'Also use it when...' with concrete trigger phrases. Not a 4: both halves are explicit and concrete rather than one being weakly implied.

5 / 5

Trigger Term Quality

Comprehensive natural trigger coverage including synonyms users actually say — 'new to Basic Memory', 'get started', 'set up', 'onboard', 'doesn't know what to use it for', 'how to organize their memory project or knowledge base', 'how to make their assistant remember context between sessions'. Not a 4: it covers synonyms and phrasings broadly with no obvious common term missing.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — onboarding a novice to Basic Memory — with distinct triggers ('new to', 'get started', 'onboard') that differ from companion skills handling note-writing or schema mechanics. Not a 4: the triggers are scoped to setup/onboarding, leaving minimal overlap risk with the related memory-* skills.

5 / 5

Total

20

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.