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.

76

Quality

96%

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

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

An exemplary SKILL.md body: dense research-backed findings, verified executable commands with documented exit codes, an explicit validation gate with feedback semantics, and clean one-level progressive disclosure to a complete bundle. No penalizable padding, teaching of known concepts, or dead references were found.

DimensionReasoningScore

Conciseness

Lean and dense: the four-lenses table delivers research findings Claude does not know ("Construction energy exceeds total query energy across 300 queries", "It is all KV cache in HBM"), the workflow block is bare commands, and nothing teaches known concepts. The three sentences of framing ("a memory engineer optimizes what it forgets") define the skill's core principle rather than pad. Every token earns its place.

5 / 5

Actionability

Fully executable: the five-step bash block is copy-paste ready and every flag was verified against the scripts' argparse (--print-sample-spec, --spec, --constraints, --dir, --policy, plus --output json and --sample as claimed). Exit-code interpretation per script is given ("0 · 2 finding · 3 bad input", "0 PASS · 2 CONDITIONAL · 4 FAIL"), and input provenance is covered (step 1 generates workload.json; the fillable forgetting_policy_template covers F1–F8).

5 / 5

Workflow Clarity

Clear 5-step sequence with explicit validation and feedback loops: "if construction dominates, cut construction tokens *before* touching retrieval", "on a tie it asks, exit 2", "Exit 4 is a stop, not a suggestion", a conditional skip ("skip if greenfield"), and a prove-by-hand-before-scheduling rule for step 5. Error semantics are defined by hard rule 6 ("A non-zero exit is a result to surface, not an error to swallow"). Not 4: checkpoints and error paths are explicit, not implicit.

5 / 5

Progressive Disclosure

Scored against the actual bundle: all 4 references, 3 assets, and 4 scripts referenced in the body exist on disk, and references are one level deep — the body keeps only findings and exit codes while sources and section detail ("§7", "(7 sources)") live in the referenced files. Each reference gets a one-line scope description, and the "References and assets" section plus scripts table make navigation trivial.

5 / 5

Total

20

/

20

Passed

Description

92%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: explicit 'Use when' triggers paired with concrete third-person capability statements that map one-to-one onto the skill's scripts and gate. The only weakness is trigger-term coverage that misses a few common phrasings like 'context window' or 'vector store'.

DimensionReasoningScore

Specificity

Multiple concrete actions in third person: "Prices the write path, picks which cost to pay, classifies records as facts / skills / logs, and refuses a design that has no forgetting policy", plus "auditing what a CLAUDE.md or memory directory actually holds" and "choosing between long-context / RAG / graph / agentic memory" — coverage maps to every script plus the gate. Not 4: no coverage gaps; the action set is comprehensive for the skill.

5 / 5

Completeness

Explicitly answers both: 'what' via "Prices the write path, picks which cost to pay, classifies records as facts / skills / logs, and refuses a design that has no forgetting policy" and 'when' via "Use when designing, reviewing, or paying for an agent memory system" with concrete trigger phrases (adding memory, choosing architectures, auditing, deciding what to expire).

5 / 5

Trigger Term Quality

Good natural phrases users would say: "adding memory to an agent", "long-context / RAG / graph / agentic memory", "memory store keeps growing", "what to keep and what to expire", with synonyms (memory system / store / directory). Not 5: a few common natural terms are missing (e.g., "context window", "vector store/database", "knowledge base"); not 3: coverage goes well beyond the 'some relevant keywords' anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche — engineering an agent memory system with a forgetting gate — with distinct decision-context triggers ("choosing between long-context / RAG / graph / agentic memory", "deciding what to keep and what to expire"). Only minimal overlap risk (the CLAUDE.md audit mention brushes an init-type skill, but the auditing frame is distinct).

5 / 5

Total

19

/

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