memory-ingest

Process unstructured external input (meeting transcripts, conversation logs, pasted documents) into structured Basic Memory entities. Extracts entities, searches for existing matches, proposes new entities with approval, creates notes with observations and relations, and captures action items.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/memory-ingest/SKILL.md

Quality

Content

65%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured ingest workflow with excellent concrete examples, somewhat held back by length/repetition, absent post-creation validation loops, and no use of progressive disclosure via reference files.

Suggestions

Add a verification step after batch entity creation (e.g., confirm created notes exist and relations resolve) to establish an explicit validate->fix feedback loop.

Move the reusable note templates and observation-category table into a references/ file and link to it from SKILL.md to reduce inline repetition.

Condense the Person/Organization/Concept templates by showing one full example and parameterizing the differences rather than repeating three full blocks.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of basic-concept padding, but ~310 lines with three near-identical full write_note templates and a workflow overview that restates each step could be tightened.	2 / 3
Actionability	Provides fully executable, copy-paste-ready write_note() and search_notes() calls with concrete parameters, plus concrete proposal and action-item formats.	3 / 3
Workflow Clarity	The 8-step sequence is clear with an approval checkpoint and search-before-create, but batch entity creation lacks an explicit validation/feedback loop, capping this dimension at 2 per the rubric guideline.	2 / 3
Progressive Disclosure	Well-organized into clear sections, but everything lives in a single 310-line SKILL.md with no reference files; templates and observation-category tables that could be split out are inline.	2 / 3
	Total	9 / 12 Passed

Description

82%Weight 40%Scale 1-3

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 specific, action-rich description with good natural trigger terms and a clear niche, but it omits an explicit 'Use when...' clause so the when-to-use guidance is only implied.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user pastes a meeting transcript, conversation log, or document to be added to Basic Memory.'

Consider adding 'process these notes' or 'add this to Basic Memory' as explicit trigger phrases users naturally say.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Extracts entities, searches for existing matches, proposes new entities with approval, creates notes with observations and relations, and captures action items' — matching the multi-action anchor.	3 / 3
Completeness	Strong 'what' via the action list, but there is no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric cap completeness is held at 2.	2 / 3
Trigger Term Quality	'meeting transcripts, conversation logs, pasted documents' are natural terms a user would say when needing this skill, giving good coverage of the input categories.	3 / 3
Distinctiveness Conflict Risk	The 'structured Basic Memory entities' ingest niche with paste/transcript triggers is distinct from related research/task skills and unlikely to fire for the wrong skill.	3 / 3
	Total	11 / 12 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-ingest/SKILL.md
Commit: cb95e59

Reviewed: 11 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.