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.

64

Quality

81%

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

The canonical home for this skill is agent-memory in alirezarezvani/claude-skills

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, well-structured body that sequences the tier/gate lifecycle with real safety checkpoints and concrete commands, held back from excellence only by references that point outside the shipped bundle. Conciseness is exemplary; actionability and workflow clarity are strong; progressive disclosure is undermined by dangling paths.

Suggestions

Ship the referenced files in the bundle: scripts/memory_inspect.py, scripts/memory_promote.py, and the rationale/schema content, so the copy-paste commands actually execute.

Move DESIGN.md inside the skill bundle (e.g., references/DESIGN.md) and link it as a relative path within the skill directory instead of ../../DESIGN.md, which escapes the skill root.

Show the adopt step concretely — what /cs:memory adopt runs, what backup it creates, and what the user reviews before confirming — to close the last workflow gap.

DimensionReasoningScore

Conciseness

The ~90-line body is lean and every section carries distinct information: problem framing, a compact tier table, gate thresholds, runnable commands, hook config, and hard rules. It assumes Claude's competence (never explains what CLAUDE.md or hooks are) and includes no padding, matching the "every token earns its place" anchor. The 6-line "Forcing questions" section is the only arguably trimmable material, but it is brief and purposeful.

5 / 5

Actionability

Guidance is concrete: exact commands with flags ("python3 scripts/memory_inspect.py --why \"PR base branch is dev\"", "--contested"), a dry-run promotion pass, named hooks, and per-hook env-var kill switches ("AGENT_MEMORY_SESSIONEND=0"). It falls short of fully executable because the referenced scripts (scripts/memory_inspect.py, scripts/memory_promote.py) and the /cs:memory adopt command are not present in the bundle, so the commands cannot actually run as shipped.

4 / 5

Workflow Clarity

The promotion lifecycle is clearly sequenced by tier (L0→L1→L2→L3) with explicit gate criteria ("≥ 3 distinct sessions spanning ≥ 2 distinct calendar days"), refusal conditions, and safety checkpoints ("dry-run the promotion pass; writes nothing", adopt "backs both up first", hooks "fail open"). The gap keeping it below a 5 is that the operational loop is assembled implicitly across sections — the human's adopt step is referenced ("/cs:memory adopt") but never shown as a runnable step.

4 / 5

Progressive Disclosure

Section structure is good and the single external pointer is clearly signaled with its contents named ("Rationale, open decisions, field schema: DESIGN.md"), keeping the body appropriately short. However, the bundle contains no scripts/, references/, or DESIGN.md — the referenced script paths and the ../../DESIGN.md pointer (which also escapes the skill directory) resolve to nothing, so navigation is broken as shipped rather than merely imperfectly organized.

3 / 5

Total

16

/

20

Passed

Description

78%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 well-crafted description with an explicit, multi-branch "Use when" trigger set and a concrete statement of the mechanism, scoring full marks on completeness. Its main flaws are the second-person trigger framing ("you want the agent to...") and trigger vocabulary that omits a few common synonyms.

Suggestions

Rewrite the trigger in third person to avoid the specificity penalty: e.g., "Use when a project's CLAUDE.md has grown past what anyone reads and the agent should learn durable facts from its own sessions instead".

Add a few natural synonyms users would say — "remember this", "the agent keeps forgetting", "persistent context" — to broaden trigger coverage toward the top anchor.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "Implements a four-tier store (L0 transcripts / L1 candidates / L2 project context / L3 stable persona)", promotion "earned by recurrence across sessions and days", and "nothing reaches a committed file without a human adopting it" — which would merit a 4. However, the trigger clause is framed in second person ("you want the agent to learn durable facts"), which the judging guidelines penalize by reducing specificity by 1.

3 / 5

Completeness

Explicitly answers both questions: the "what" is stated concretely ("Implements a four-tier store... promotion is earned by recurrence... nothing reaches a committed file without a human adopting it") and the "when" opens with "Use when a project's CLAUDE.md has grown past what anyone reads" plus three concrete alternative trigger phrases. This matches the anchor-5 example pattern of "concrete what + explicit 'Use when' with concrete trigger phrases".

5 / 5

Trigger Term Quality

Good coverage of natural phrases a user would actually say: "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". A few natural synonyms are missing (e.g., "remember this", "forget", "persistent context"), which keeps it below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and the triggers are distinctive — session-derived memory with recurrence-gated promotion and provenance questions like "where a memory line came from" are unlikely to fire for an unrelated skill. Minor overlap risk remains with other memory/CLAUDE.md-management skills, since the description does not itself differentiate from e.g. a manually-written knowledge vault.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 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

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

13

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.