CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-claude-memory

Auto-Claude Graphiti memory system configuration and usage. Use when setting up memory persistence, configuring LLM/embedding providers, querying knowledge graph, or optimizing memory performance.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/auto-claude-memory/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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, largely actionable reference for configuring Graphiti memory, with concrete provider configs, commands, and troubleshooting. Its weaknesses are redundancy across six inlined provider blocks (duplicating an unreferenced .env.example bundle file), a padded conceptual/best-practices layer, and no explicit sequenced setup workflow with validation — especially around destructive reset commands.

Suggestions

Replace the six inlined provider env blocks with a compact provider-matrix table and link to the existing references/.env.example for full configurations — the bundle file is currently never referenced.

Add a numbered setup workflow with validation checkpoints (enable → configure provider → run the credential check → verify a test query round-trips), and add pre/post checks around destructive operations like 'rm -rf ~/.auto-claude/memories/embeddings'.

Cut the 'Memory in Action' dialogue and generic Best Practices bullets ('let agents learn naturally', 'use semantic search') that restate what the operational sections already demonstrate, and explain the parameters in get_graphiti_memory(spec_dir, project_dir).

DimensionReasoningScore

Conciseness

Mostly efficient — the bulk is concrete env blocks, tables, and commands — but includes unnecessary sections: the 'Memory in Action' anthropomorphic session dialogue, 'How Memory Works' conceptual narration, and Best Practices filler like 'Let agents learn naturally — don't force memory storage'. The six near-identical per-provider env blocks also repeat what a single table (or the bundle's .env.example) could hold. Matches the level-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'); far from the padded level-1/2 examples.

3 / 5

Actionability

Mostly executable: concrete env configurations per provider, runnable commands (python query_memory.py --search, curl provider health checks), and copy-ready Python API snippets. Not a 5 due to minor gaps — get_graphiti_memory(spec_dir, project_dir) is called with unexplained parameters, and the constructor kwargs in the Custom Memory Integration example are not validated against the documented API.

4 / 5

Workflow Clarity

The setup flow (enable → pick provider → configure → verify) is implied by section order but never laid out as an explicit sequence, and verification lives only in the Troubleshooting section. Destructive operations appear without feedback loops: 'rm -rf ~/.auto-claude/memories/embeddings' has no pre-check or post-verification, so per the rubric's feedback-loop cap workflow_clarity cannot exceed 3. The DB reset does include a backup (mv to .backup), which keeps this from scoring lower.

3 / 5

Progressive Disclosure

Good internal structure (clear headers, tables, per-topic sections), but the bundle contains references/.env.example (13KB of provider configuration) that the body never links to, while six provider env blocks that overlap it are inlined in SKILL.md. Matches the level-3 anchor ('some structure; content that should be separate is inline; references not clearly signaled'); better than level 2 because sections and navigation within the document are solid.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid description with an explicit 'Use when...' trigger clause and several concrete action areas in third-person voice. The main weaknesses are a generic what-clause ('configuration and usage'), missing natural trigger synonyms (cross-session memory, remember, MCP memory tools), and slight overlap with sibling auto-claude skills on the performance-optimization trigger.

Suggestions

Replace the vague what-clause 'configuration and usage' with concrete capabilities, e.g. 'Configures Graphiti-based persistent memory (provider setup, knowledge-graph queries, episode storage) for Auto-Claude'.

Add natural trigger synonyms users would actually say: 'remembering across sessions', 'cross-session context', 'memory not persisting', 'MCP memory tools'.

Sharpen the 'optimizing memory performance' trigger to 'tuning Auto-Claude's Graphiti memory (models, embeddings, dimensions)' to reduce overlap with the sibling auto-claude-optimization skill.

DimensionReasoningScore

Specificity

Lists several concrete actions — "setting up memory persistence, configuring LLM/embedding providers, querying knowledge graph, or optimizing memory performance" — comparable to the level-4 anchor ('several specific actions; minor gaps'). Not a 5 because coverage has gaps: troubleshooting (a large section of the body), MCP tools, and the Python API are not represented; not a 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

Both parts are present: the what ("Auto-Claude Graphiti memory system configuration and usage") and an explicit when ("Use when setting up... configuring... querying... or optimizing...") with concrete triggers, matching the level-4 anchor. Not a 5 because the what-clause is generic ('configuration and usage') rather than stating concrete capabilities like configuring providers, querying the knowledge graph, or troubleshooting memory issues.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "memory persistence", "LLM/embedding providers", "knowledge graph", "memory performance", plus the distinctive "Graphiti". Falls short of the level-5 anchor (comprehensive synonyms/extensions, e.g. 'PDF files, PDFs, .pdf') because common user phrasings like remembering across sessions, cross-session context, MCP memory tools, or vector/embedding search are absent; better than level 3 since the present terms are natural and varied.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Auto-Claude's Graphiti memory system) and mostly distinct, but the trigger "optimizing memory performance" overlaps with the sibling skill "auto-claude-optimization" referenced in the body, matching the level-4 anchor ('minor overlap risk with closely related skills'). More distinct than level 3 because the Graphiti/auto-claude framing would not fire for unrelated skills.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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