CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-management

Use when the user asks to "remember project context", review saved findings, initialize runtime memory, archive stale work, reconcile notes, or erase a subject; manages authorized HOT/WARM/COLD working memory across all disciplines while preserving registry event ownership and privacy controls. Not for changing canonical registry facts - route those through the owning registry. 项目记忆/跨会话

Quality

73%

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 ./protocol/memory-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured, unusually rigorous operational skill with concrete commands, explicit decision gates, and validation checkpoints on destructive operations. Its weaknesses are repeated authorization/governance prose that inflates token cost, scripts referenced but absent from the bundle, and four reference links that point outside the bundle and do not resolve.

Suggestions

Consolidate the authorization rules repeated across Decision Gates, Capture and Promote, and Save Results into a single authorization section referenced once, cutting roughly 15-20% of the body's tokens.

Fix or inline the four broken references (state-model.md, registry-event-protocol.md, runtime-invocation.md, skill-contract.md) that resolve to ../../references/ outside the bundle, since the local references/ directory does not contain them.

Add explicit error-recovery loops for the validate-audit-artifact.py and projection-rebuild steps (e.g., 'if validation fails: fix schema violations and re-run; do not write the sink until it passes') to raise workflow clarity, and bundle or stub the referenced scripts/ (registry-events.py, validate-audit-artifact.py) so the commands are actually executable.

DimensionReasoningScore

Conciseness

The body is dense with genuinely domain-specific rules (authority order, 80-line HOT cap, 30/90-day demotion) and avoids explaining concepts Claude already knows, but authorization caveats recur across Decision Gates, Capture and Promote, Save Results, and Privacy sections, and the registry-governance vocabulary is stated repeatedly. It could be tightened noticeably by consolidating those repeated consent rules, matching the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened").

3 / 5

Actionability

Guidance is largely executable: concrete commands ("python3 \"$AARON_SKILLS_ROOT/scripts/registry-events.py\" init", "is-suppressed <aggregate-id>", "validate-audit-artifact.py <artifact> --relative-path <artifact>"), exact paths (memory/templates/session-checkpoint.md), and numeric caps (80 lines / 25 KB, 40 lines / 8 KB). Not a 5 because the invoked scripts (registry-events.py, validate-audit-artifact.py, claude-hook.sh) are not present in the bundle, and several steps are policy statements with no corresponding executable artifact.

4 / 5

Workflow Clarity

The seven operations are clearly sequenced, and the destructive purge path has explicit checkpoints: dry search first, "Confirm suppression by replay, not by a cached view", "Rebuild and verify projections", and a final precise-scope report. It misses the 5 anchor because there are no explicit error-recovery/feedback loops (e.g., what to do when validate-audit-artifact.py fails or a projection rebuild mismatches).

4 / 5

Progressive Disclosure

There is good structure — a dedicated Reference Materials section, one-level-deep local references that all exist (promotion-demotion-rules.md, consolidation-pass.md, update-triggers-integration.md, examples.md) — but four referenced paths (state-model.md, registry-event-protocol.md, runtime-invocation.md, skill-contract.md) point to ../../references/ outside the bundle and do not resolve, and substantial policy detail (privacy/erasure, audit rules) is inlined that could live in reference files. This lands between the 3 and 4 anchors; the unresolvable references push it to 3.

3 / 5

Total

14

/

20

Passed

Description

75%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, well-phrased trigger clause and a useful negative boundary. Its main weakness is that the capability statement is written in the skill's internal vocabulary (HOT/WARM/COLD, registry event ownership), which blurs the "what" for users outside that ecosystem and includes minor fluff.

DimensionReasoningScore

Specificity

The description names several concrete operations — "initialize runtime memory, archive stale work, reconcile notes, or erase a subject" — plus what is managed ("authorized HOT/WARM/COLD working memory", "registry event ownership and privacy controls") and an explicit negative boundary ("Not for changing canonical registry facts"). It falls short of the 5 anchor because the capability statement leans on internal jargon (HOT/WARM/COLD, registry event ownership) rather than fully plain actions, and includes fluff ("across all disciplines").

4 / 5

Completeness

Both halves are explicit: an explicit "Use when..." clause with concrete trigger phrases, and a "what" statement ("manages authorized HOT/WARM/COLD working memory..."). It sits below the 5 anchor because the "what" is expressed in ecosystem jargon that a user cannot readily map to actions without prior context, and "across all disciplines" is padding; it is above the 4 anchor's typical weakness since the "when" clause is unusually explicit.

4 / 5

Trigger Term Quality

Quoted natural phrases like "remember project context", "review saved findings", "archive stale work", and "erase a subject" read as things a user would actually say. Not a 5 because common user phrasings such as "save this for later", "what did we decide last session", or "forget about X" are absent, and terms like "reconcile notes" and "reconciling" skew technical.

4 / 5

Distinctiveness Conflict Risk

The HOT/WARM/COLD lifecycle, purge/erasure framing, and the explicit exclusion ("Not for changing canonical registry facts - route those through the owning registry") carve out a clear niche. It is not a 5 because generic memory phrases like "remember project context" could overlap with ordinary note-taking or CLAUDE.md-style skills.

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

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

protocol/memory-management/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.