CtrlK
BlogDocsLog inGet started
Tessl Logo

memory-engineering

Use when designing, reviewing, or paying for an agent memory system — adding memory to an agent, choosing between long-context / RAG / graph / agentic memory, auditing what a CLAUDE.md or memory directory actually holds, deciding what to keep and what to expire, or when a memory store keeps growing and nobody has said what leaves it. Prices the write path, picks which cost to pay, classifies records as facts / skills / logs, and refuses a design that has no forgetting policy.

73

Quality

92%

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 memory-engineering in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 an unusually well-engineered overview: executable commands, explicit exit-code validation gates, a hard-rules section, and clearly signaled one-level-deep references. Its one material defect is that the shipped bundle is empty — the seven linked files and four workflow scripts do not exist, so the carefully designed navigation and workflow cannot actually be followed.

Suggestions

Ship the bundle files: all 7 referenced paths (references/memory_cost_canon.md, references/what_to_keep.md, references/memory_control_and_governance.md, references/forgetting_policy_design.md, assets/memory_engineer_worksheet.md, assets/memory_design_spec.example.json, assets/forgetting_policy_template.md) and the 4 scripts dangle — none of the directories exist, so every workflow command errors immediately.

Define step 4's input provenance: design.json appears in "python scripts/forgetting_policy_linter.py --policy design.json" without being produced by any prior step — link it to assets/memory_design_spec.example.json or the forgetting_policy_template.md so all workflow inputs are accounted for.

Trim the rhetorical framing in "What this does" (e.g., "Memory is not a bucket — it is a system with a metabolism", "The problem was never that an agent forgets — it is that it never forgets *on purpose*") to tighten token efficiency without losing the hard rules that carry the same constraints.

DimensionReasoningScore

Conciseness

The body is dense and information-rich (four-lenses table, exit-code table, hard rules), but the rhetorical framing in "What this does" — "Memory is not a bucket — it is a system with a metabolism" and "it never forgets *on purpose*" — is editorial padding a competent model doesn't need to act. Anchors 5 requires every token to earn its place; these passages could be trimmed without losing guidance, matching anchor 4's "minor instances of over-explanation that could be trimmed".

4 / 5

Actionability

The workflow is copy-paste ready with fully specified commands and flags ("python scripts/memory_cost_profiler.py --print-sample-spec > workload.json", "python scripts/forgetting_policy_linter.py --policy design.json"), plus a scripts table documenting exit codes ("0 · 2 finding · 3 bad input") and "All support `--output json` and `--sample` (no input file needed)". This matches anchor 5: fully executable commands covering the common cases.

5 / 5

Workflow Clarity

The five-step sequence is explicit with per-step validation semantics: each script's exit codes are documented, "Exit 4 is a stop, not a suggestion" and "on a tie it asks, exit 2" define error recovery, and step 5 adds a manual-verification gate ("Run it once against real history and ask whether it changed a decision"). This matches anchor 5's clear sequence with explicit validation steps and feedback loops; the operations are read-only analysis so the destructive-operation cap does not apply. The only wrinkle — where step 4's design.json originates — is a minor input-provenance gap, not a validation gap.

5 / 5

Progressive Disclosure

On paper the structure is anchor-5 quality: a concise overview with seven clearly signaled one-level-deep links ("references/memory_cost_canon.md — construction dominance...", "assets/forgetting_policy_template.md — fillable policy covering F1–F8"). But per the judging guideline to score against the actual bundle structure, no references/, scripts/, or assets/ files exist in this bundle — every referenced path dangles and every workflow command points at a missing script, so navigation fails in practice. This falls between anchors 3 and 4: references are clearly signaled (better than 3's "not clearly signaled") but the bundle delivers none of the structure it promises (worse than 4's "minor organization gaps").

3 / 5

Total

17

/

20

Passed

Description

100%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 exemplary: an explicit "Use when" trigger clause with concrete, natural trigger phrases; specific third-person actions covering the full capability surface; and a clearly bounded niche (memory-system design/pricing/auditing with a forgetting gate) that minimizes conflict with adjacent skills. It reads as a model trigger description.

DimensionReasoningScore

Specificity

It lists multiple concrete actions in third person — "Prices the write path, picks which cost to pay, classifies records as facts / skills / logs", "auditing what a CLAUDE.md or memory directory actually holds", "choosing between long-context / RAG / graph / agentic memory", "refuses a design that has no forgetting policy" — with comprehensive coverage of the skill's capabilities. This matches anchor 5; it is well above anchor 4's "minor gaps in coverage" since it names the pricing, selection, audit, classification, and gating functions.

5 / 5

Completeness

Both what and when are explicit: "Use when designing, reviewing, or paying for an agent memory system — adding memory to an agent, choosing between..., auditing..., deciding what to keep and what to expire, or when a memory store keeps growing" gives concrete trigger phrases, and "Prices the write path, picks which cost to pay, classifies records as facts / skills / logs, and refuses a design that has no forgetting policy" clearly states what it does. This is exactly anchor 5; it far exceeds anchor 4's "'when' could be more explicit".

5 / 5

Trigger Term Quality

Natural phrases a user would actually say are comprehensively covered: "adding memory to an agent", "agent memory system", "long-context", "RAG", "CLAUDE.md", "memory directory", "what to keep and what to expire", and "when a memory store keeps growing and nobody has said what leaves it" — including the colloquial symptom phrasing users reach for. This matches anchor 5's comprehensive natural-term coverage with synonyms; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — memory-system engineering with cost pricing and a forgetting-policy gate — with triggers unlikely to fire for adjacent skills ("paying for an agent memory system", "deciding what to keep and what to expire", "refuses a design that has no forgetting policy"). The niche is distinct from generic documentation, RAG-implementation, or consolidation-loop skills; the only conceivable overlap (a plain "audit my CLAUDE.md" request) is still squarely inside this skill's declared scope, matching anchor 5's minimal conflict risk.

5 / 5

Total

20

/

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: 7 missing

Warning

referenced_paths_exist

Referenced path issues: 23 missing

Warning

Total

13

/

16

Passed

Repository
alirezarezvani/claude-skills
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.