CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-memory

Use when a project's CLAUDE.md has grown past what anyone reads and you want the agent to learn durable facts from its own sessions instead — or when asking why the agent keeps re-learning the same correction, why a remembered rule is wrong, or where a memory line came from. Implements a four-tier store (L0 transcripts / L1 candidates / L2 project context / L3 stable persona) where promotion is earned by recurrence across sessions and days, never by one confident statement, and nothing reaches a committed file without a human adopting it.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 tight, executable body with unusually strong safety checkpoints (dry-run, staging, backup, quarantine) around its destructive adopt step. Its one structural weakness is navigation: all deep-dive material sits in unlinked bundle files, and the single outbound link escapes the skill directory.

Suggestions

Link the three references/ files from the sections they deepen — e.g., the gates section should point to references/promotion_gate_design.md and the hook paragraph to references/hook_capture_discipline.md — so the bundled detail is discoverable from SKILL.md.

Fix the final line's link: "../../DESIGN.md" points outside the skill bundle. Either move DESIGN.md into references/ and link it there, or replace it with links to the existing references/ files and assets/memory_schema.json ("field schema" currently points at DESIGN.md while the actual schema sits unlinked in assets/).

Add a short end-to-end sequence (capture → inspect → dry-run promote → review staged → adopt) so the reader does not have to assemble the pipeline from four separate sections.

DimensionReasoningScore

Conciseness

The body is dense with material Claude does not already know — the tier/injection table, numeric gates ("≥ 3 distinct sessions spanning ≥ 2 distinct calendar days"), env-var toggles — and explains no basic concepts. Two sections could be trimmed: the "The problem" narrative and especially "Forcing questions", which addresses the human reader rather than instructing the agent. That is more than zero padding but well short of the anchor-3 "some unnecessary explanation" level.

4 / 5

Actionability

Every user-facing command is copy-paste ready with real flags: "python3 scripts/memory_inspect.py --tier L1", "--why \"PR base branch is dev\"", "--contested", and "python3 scripts/memory_promote.py" marked "dry-run the promotion pass; writes nothing"; both referenced scripts exist in the bundle. Hook control via AGENT_MEMORY_SESSIONSTART=0-style env vars and the explicit "/cs:memory adopt" command cover the remaining cases.

5 / 5

Workflow Clarity

The L0→L3 ladder is a clear sequence with explicit gates, and validation checkpoints are present for the destructive step (dry-run promotion, staged proposals in ".memory/staged/", "it backs both up first" on adopt, quarantine of redacted claims, freeze on contradiction) — so the destructive-operation cap does not apply. What keeps it below 5 is that no single end-to-end walkthrough (capture → inspect → promote → adopt) ties the sections together, and hook setup is only described, not shown.

4 / 5

Progressive Disclosure

The body itself is well-sectioned and appropriately lean, but the reference layer is disconnected: the only detail link, "Rationale, open decisions, field schema: ../../DESIGN.md", points outside the bundle rather than to a bundled file, while the three files in references/ (hook_capture_discipline.md, promotion_gate_design.md, tiered_memory_canon.md) and assets/memory_schema.json are never referenced from SKILL.md at all. Deep material exists but is undiscoverable from the entry point — structure is present, signaling is not.

3 / 5

Total

16

/

20

Passed

Description

86%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 description with an explicit, natural-sounding trigger clause and a precise statement of the four-tier promotion mechanism. Its only real defects are the second-person "you want" phrasing (which costs it specificity under the rubric's voice rule) and a first trigger clause broad enough to overlap neighboring memory skills.

Suggestions

Rewrite the trigger clause in third person to avoid the rubric's voice penalty — e.g., "Use when a project's CLAUDE.md has grown past what anyone reads and the goal is for the agent to learn durable facts from its own sessions instead."

Consider naming one or two concrete operations (inspecting what is remembered, querying why a line exists) so the capability list covers what a user can actually invoke, not just the mechanism.

DimensionReasoningScore

Specificity

Concrete mechanisms are named — "Implements a four-tier store (L0 transcripts / L1 candidates / L2 project context / L3 stable persona) where promotion is earned by recurrence across sessions and days" and "nothing reaches a committed file without a human adopting it" — which alone would merit a 4. However, the trigger clause "you want the agent to learn durable facts from its own sessions" is second-person voice, which the rubric penalizes by one point on this dimension. Coverage also omits the concrete operations the skill offers (inspect, provenance queries, adopt).

3 / 5

Completeness

Both halves are explicit: what — "Implements a four-tier store (L0 transcripts / L1 candidates / L2 project context / L3 stable persona) where promotion is earned by recurrence... and nothing reaches a committed file without a human adopting it"; when — an explicit "Use when..." clause with three concrete trigger scenarios. This matches the anchor-5 example's structure.

5 / 5

Trigger Term Quality

The triggers read as natural user utterances: "a project's CLAUDE.md has grown past what anyone reads", "why the agent keeps re-learning the same correction", "why a remembered rule is wrong", "where a memory line came from". They include the artifact name (CLAUDE.md) and phrasings a user would actually say across the skill's scenario space, with no jargon-only gaps.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and the symptom-based triggers (CLAUDE.md bloat, memory-line provenance, re-learning corrections) are distinct, but the first trigger clause — wanting "the agent to learn durable facts from its own sessions" — is broad enough to also fire for closely related session-memory or memory-audit skills. Minor overlap risk, matching the anchor-4 example.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

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