CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-memory-mcp

A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).

58

Quality

73%

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/agent-memory-mcp/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-sequenced, security-conscious setup guide with genuinely executable commands and explicit approval/validation checkpoints — its strongest dimension. Weaknesses are minor: a redundant intro line, placeholder arguments in a couple of commands, and an inline MCP tool reference that could be split out as the skill grows.

DimensionReasoningScore

Conciseness

The body is efficient: concrete commands, compact arg lists, and no explanations of concepts Claude already knows. Minor trimming is possible (the intro paragraph restates the frontmatter description, and 'Usage' example lines for tools like memory_stats add slight padding), matching anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

The setup provides copy-paste-ready commands (git clone with pinned commit, npm ci, npm run start-server with a concrete example) and MCP tool calls with typed args and usage examples. Anchor 5 is not quite met because 'cd <approved-agent-memory-directory>' and '<project_id>' remain placeholders the model must fill; this fits anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps').

4 / 5

Workflow Clarity

The 3-step setup is clearly sequenced with explicit validation checkpoints: inspect lockfiles/lifecycle scripts before install, 'Show the findings and exact commit, then wait for explicit user approval', and 'verify the resulting file changes' after writes. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery') and involves no destructive or batch operation left unvalidated.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and no dangling reference paths in the body; the single file is organized into clear sections (Prerequisites, Setup, Storage Boundary, Capabilities, Dashboard, When to Use, Limitations). At ~105 body lines it exceeds the 'under 50 lines' threshold that would allow a 5 without external files, and its size suggests some material (MCP tool reference) could live in a separate file, so anchor 4 ('good structure; most content appropriately placed; minor organization gaps') is the best fit.

4 / 5

Total

17

/

20

Passed

Description

53%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 in third person and names a distinct domain, but it reads as a capability summary rather than a trigger: it lacks any 'Use when...' guidance and omits natural trigger terms users would actually say. It answers 'what' adequately but leaves 'when' entirely implicit.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants an agent to remember, recall, or persist architecture decisions, patterns, or project knowledge across sessions.'

Include natural synonyms and concrete capability verbs users would say: 'remember', 'recall', 'long-term memory', 'search past decisions', and mention it runs as an MCP server.

List the concrete actions (write, read, search memories; sync with project documentation) so coverage is comprehensive rather than implied by 'knowledge management'.

DimensionReasoningScore

Specificity

The description names the domain ("memory system", "knowledge management for AI agents") and two concrete properties ("persistent, searchable"), but does not enumerate the actual capabilities (write, read, search, sync with project documentation, MCP server). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than anchor 4, which requires several specific listed actions.

3 / 5

Completeness

The 'what' is clear ('provides persistent, searchable knowledge management for AI agents'), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. This matches anchor 3 ('has a clear what but when is missing or only weakly implied').

3 / 5

Trigger Term Quality

Relevant keywords are present ("memory", "knowledge management", "AI agents", "Architecture, Patterns, Decisions"), but common natural variations users would say are missing ("remember", "recall", "long-term memory", "MCP server", "save decisions"). Fits anchor 3 ('some relevant keywords but missing common variations or synonyms'), not anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The phrase 'hybrid memory system... for AI agents (Architecture, Patterns, Decisions)' carves out a fairly distinct niche with minor overlap risk against other memory/knowledge-base skills. Matches anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5, since 'knowledge management' alone could overlap with generic note-taking or documentation skills.

4 / 5

Total

13

/

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

sickn33/agentic-awesome-skills

Path

skills/agent-memory-mcp/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.