CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-memory-systems

You are a cognitive architect who understands that memory makes agents intelligent. You've built memory systems for agents handling millions of interactions. You know that the hard part isn't storing - it's retrieving the right memory at the right time.

32

Quality

40%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/agent-memory-systems/SKILL.md

The canonical home for this skill is agent-memory-systems in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

22%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 skeleton with almost no instructional content: persona prose duplicated from the frontmatter, a dangling unfinished sentence ('…embedding quality, and'), bare keyword/heading placeholders, and a corrupted Sharp Edges table whose Solution column contains orphaned headings from another document. A Claude loading this skill would learn essentially nothing actionable about building or debugging agent memory systems.

Suggestions

Replace the empty Patterns/Anti-Patterns headings with actual guidance — concrete chunking approaches (e.g. contextual chunking with a worked example), a vector-store selection decision table, and why each anti-pattern fails.

Fix or regenerate the corrupted Sharp Edges table (placeholder 'Issue' cells and Solution column containing stray '##' headings) and complete the truncated sentence at '…embedding quality, and'.

Delete the duplicated persona paragraph and the boilerplate 'When to Use' line; replace them with a concrete 'When to use this skill' trigger list and real decision guidance.

DimensionReasoningScore

Conciseness

The body opens by duplicating the frontmatter persona verbatim ('You are a cognitive architect… You've built memory systems…'), wastes lines on a 10-item bare keyword 'Capabilities' list, and closes with boilerplate filler ('This skill is applicable to execute the workflow or actions described in the overview.') — several padded sections that earn no tokens. It is above anchor 1 because it does not explain concepts Claude already knows at length, but below anchor 3 because the persona duplication and filler lines are clearly unnecessary.

2 / 5

Actionability

There is no code, no command, and no concrete procedure anywhere; 'Patterns' sections are one-line descriptions ('Choosing the right vector database for your use case', 'Breaking documents into retrievable chunks') and the anti-patterns are bare headings. A few fragmentary hints exist ('Always filter by metadata first', 'Add temporal scoring', 'Detect conflicts on storage') — high-level hints without executable steps, matching anchor 2. Not anchor 1 because those hints are slightly more directive than pure abstract description; not anchor 3 because nothing is executable or complete.

2 / 5

Workflow Clarity

No sequence of steps exists anywhere in the body — it is a catalog of headings (Capabilities, Patterns, Anti-Patterns) with no ordering or process, and the 'Sharp Edges' table is corrupted (rows read 'Issue | critical | ## Contextual Chunking (Anthropic's approach)', mixing in orphaned markdown from another document). This matches anchor 1: steps missing and content incoherent.

1 / 5

Progressive Disclosure

The body has clear ## section headers and no nested or buried references (no bundle files exist), which avoids anchors 1–2, and at ~64 lines it is small. But the sections are empty placeholders rather than well-organized content — several have no body at all and the one table is mangled — so it cannot reach the well-organized bar of anchors 4–5. Anchor 3 ('some structure but could be better organized') is the best fit.

3 / 5

Total

8

/

20

Passed

Description

31%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 persona fluff rather than a capability statement: second-person role text with zero concrete actions, no 'when to use' guidance, and sparse trigger keywords. It reads like a system-prompt preamble, not a skill description, and would rarely fire for a user asking about agent memory, RAG, or retrieval problems.

Suggestions

Rewrite in third person stating concrete capabilities, e.g. 'Designs and debugs agent memory systems: memory-type selection (episodic, semantic, procedural), vector store choice, chunking strategy, and retrieval evaluation.'

Add an explicit trigger clause: 'Use when building or debugging agent memory, RAG retrieval quality, long-term memory, or when an agent forgets or gives inconsistent answers.'

Include natural user-side trigger terms and synonyms — 'agent memory', 'long-term memory', 'RAG', 'retrieval', 'context management', 'vector database' — so the skill fires on real phrasings.

DimensionReasoningScore

Specificity

The description states no skill actions at all — only persona claims ('You are a cognitive architect… You've built memory systems… You know that the hard part isn't storing'). It is second-person voice throughout, which triggers the additional specificity penalty; there is nothing concrete like 'design', 'build', or 'retrieve' framed as a capability.

1 / 5

Completeness

The 'what' is only vaguely implied through persona ('You've built memory systems for agents handling millions of interactions') and the 'when' is entirely absent — no 'Use when…' clause or equivalent trigger guidance, which also caps completeness at 3 by guideline. It sits above anchor 1 because a vague 'what' is present, but below anchor 3 because that 'what' is never stated as a concrete capability.

2 / 5

Trigger Term Quality

It contains some relevant keywords ('memory systems', 'agents', 'retrieving the right memory at the right time') that a user might echo, but misses common variations and synonyms users actually say — 'RAG', 'long-term memory', 'context management', 'agent forgetting', 'vector database'. This matches anchor 3 ('Works with PDF files' level of keyword coverage), not 4, because several natural trigger phrases are absent, and not 2 because more than one or two relevant, non-generic domain keywords are present.

3 / 5

Distinctiveness Conflict Risk

The agent-memory domain is somewhat specific, but the vague persona phrasing gives it no distinct triggers, so it would overlap with RAG, context-management, and vector-database skills. It is above anchor 2 ('very broad, high overlap with many skills') because the memory niche narrows it, but below anchor 4 because no distinguishing trigger phrases are offered.

3 / 5

Total

9

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/agent-memory-systems/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.