CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-manager

Standardized workflow for discovering, reading, writing, and compacting the project's memory file (memory.instructions.md) to persist context across AI chat sessions, with a permanent Knowledge Base for cross-session decisions and lessons learned.

Quality

75%

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 ./.agents/skills/memory-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers highly actionable, template-driven workflows with strong sequencing and meaningful user-consent checkpoints, and it does not waste tokens on background concepts. Its weaknesses are repetition of the AGENTS.md rules, a monolithic 17.5KB single-file layout that inlines template and integration content which belongs in reference files, and a destructive compaction step whose user-review summary is ordered after deletion.

Suggestions

Move the three templates and the AGENTS.md Integration section into references/ files (e.g., references/templates.md, references/agents-md-integration.md) with clearly signaled one-level-deep links from SKILL.md.

Reorder Compaction Mode so the compaction summary is presented and approved before any checkpoint deletion occurs, making 'before finalizing' a genuine validation gate.

State the AGENTS.md fast-path rules once in the Integration section and reference them from Workflows 1 and 3 instead of restating them, cutting roughly a third of the repetition.

DimensionReasoningScore

Conciseness

The body is substantive and avoids explaining concepts Claude already knows, but the AGENTS.md fast-path rules are restated three times (Workflow 1 Step 0, Workflow 3 Step 5, and the AGENTS.md Integration section) and the promote-before-delete directive appears in four places, so it could be meaningfully tightened. It is not 2 because the padding is repetition of genuine project-specific rules rather than filler or generic explanation.

3 / 5

Actionability

Fully executable for an instruction-only skill: copy-paste-ready templates (Initial Memory, Mandatory Checkpoint, Knowledge Base Update, AGENTS.md snippet) plus verbatim confirmation messages cover the common cases. Per the rubric's scoring notes, the absence of code is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

All four workflows have clearly numbered sequences with explicit checkpoints (pause on multiple file matches, stale-path fallback to recursive search, user-consent gates, compaction summary before finalizing). It falls short of 5 because Compaction Step 6 deletes checkpoints before Step 8 presents the summary 'before finalizing', an ordering gap in a destructive flow, and Write Mode has no post-write verification — but validation is present rather than absent, so the destructive-operation cap of 3 does not apply.

4 / 5

Progressive Disclosure

The 270-line body is well-sectioned with clear headers, but there are no bundle files and no references at all — content that clearly belongs in separate files (the three templates, the AGENTS.md Integration details, the anti-patterns checklist) is fully inlined. This matches anchor 3's 'content that should be separate is inline' rather than 2, since structure and navigation within the file are good.

3 / 5

Total

15

/

20

Passed

Description

66%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 communicates a clear, concrete capability set around a specific artifact and is unlikely to be confused with unrelated skills. Its main deficiency is the complete absence of 'when to use' trigger guidance, which caps completeness and limits its effectiveness for skill selection. Adding a 'Use when...' clause with natural trigger phrases would lift it substantially.

Suggestions

Append a trigger clause such as: 'Use when the user asks to save, restore, or recall project context between sessions, mentions the memory file, or requests memory cleanup/compaction.'

Add natural synonym phrases users would actually say ("remember this for next time", "checkpoint our progress", "resume where we left off") to improve trigger-term coverage.

Briefly concretize the Knowledge Base half (e.g., 'promotes dead-ends, patterns, and metrics so they survive compaction') so both halves of the description state actions.

DimensionReasoningScore

Specificity

Lists several concrete actions ("discovering, reading, writing, and compacting the project's memory file (memory.instructions.md)") tied to a named artifact, with only minor gaps — the Knowledge Base half ("cross-session decisions and lessons learned") states no concrete actions, keeping it just short of anchor 5's comprehensive coverage.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description; per the rubric guidelines this caps completeness at 3 even though the purpose ("persist context across AI chat sessions") weakly implies timing.

3 / 5

Trigger Term Quality

Includes natural terms a user would say — "memory file", "memory.instructions.md", "persist context", "chat sessions", "Knowledge Base" — but misses common variations like "remember", "checkpoint", "restore context", or "resume session", matching anchor 4 rather than 5's synonym-and-extension coverage.

4 / 5

Distinctiveness Conflict Risk

The specific filename (memory.instructions.md) and Knowledge Base concept carve a mostly distinct niche with only minor overlap risk against generic note-taking or context-saving skills; it is not anchor 5 because the absence of explicit triggers leaves some ambiguity about when this skill versus a related memory skill should fire.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

glenrioariesto/social-content-studio

Path

.agents/skills/memory-manager/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.