CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-hygiene

Periodic trust sweep of persistent memory and durable knowledge notes - re-verifies environment-dependent claims against the live environment, stamps last_verified + confidence, and proposes archiving drifted entries

Quality

62%

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-hygiene/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%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 maximally lean but is a pure delegation stub: every instruction resolves to files absent from the bundle, leaving no executable content, no real workflow, and dangling references. The one well-formed part is the Antigravity substitution mapping, which is specific and actionable if the referenced files existed.

Suggestions

Inline the actual playbook steps (re-verify claims, stamp last_verified + confidence, propose archiving) into the SKILL.md body instead of delegating to a `.claude/skills/memory-hygiene/SKILL.md` file that is not in the bundle.

Add validation checkpoints before archiving or rewriting memory entries — e.g., confirm the drift evidence before proposing archive, and verify the stamped entry parses afterward — since this skill performs batch modifications of durable state.

Ship the referenced files (`.agents/rules/cog.md`, `.agents/agents/*.md`) in the bundle or remove the references so every path named in the body resolves.

DimensionReasoningScore

Conciseness

The body is 6 lines with zero padding or explanations of concepts Claude already knows; every line is a directive. It matches the 'lean and efficient; every token earns its place' anchor, and there is nothing below it to drift to since verbosity is the failure mode this dimension measures.

5 / 5

Actionability

The only concrete guidance is 'Read `.claude/skills/memory-hygiene/SKILL.md` and execute it exactly as written' plus the `invoke_subagent` substitution hint — but the entire workload is delegated to files that are not present in the bundle, so no step can actually be executed. It sits above anchor 1 (it does name specific paths and a concrete dispatch mechanism) but below anchor 3 (no executable substance exists in the skill itself).

2 / 5

Workflow Clarity

A rough two-step sequence exists ('Read the playbook... Then follow `.agents/rules/cog.md`'), but the actual steps are entirely deferred to missing files and there is no validation checkpoint for the archiving/rewrite operations the description promises. This matches 'rough sequence present but many gaps; steps poorly defined; validation absent' and is below anchor 3, which requires a real listed sequence with only checkpoint gaps.

2 / 5

Progressive Disclosure

References are one level deep and explicitly signaled, but they are dangling: the bundle contains no `.claude/`, `.agents/`, `references/`, `scripts/`, or `assets/` files, so the SKILL.md is a pass-through stub with no overview content and nothing to navigate to. It does not reach anchor 3 ('some structure... references present but not clearly signaled' is surpassed on signaling but fails on substance), and anchor 1's monolithic-wall failure mode does not apply.

2 / 5

Total

11

/

20

Passed

Description

58%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 specific, well-scoped description that names three concrete actions in a distinct niche, written in correct third-person voice. Its main weaknesses are the complete absence of any 'when to use' trigger clause and reliance on coined jargon ('trust sweep', 'durable knowledge notes') over natural user vocabulary.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to verify, clean up, or audit persistent memory, or when memories may be stale after an environment change.'

Replace coined jargon ('trust sweep', 'durable knowledge notes') with natural synonyms users would actually say ('memory audit', 'stale memories', 'verify saved notes').

State what happens to entries that pass verification, so the 'what' covers the full sweep outcome and not just the drift path.

DimensionReasoningScore

Specificity

The description lists three concrete, verifiable actions — 're-verifies environment-dependent claims against the live environment', 'stamps last_verified + confidence', 'proposes archiving drifted entries' — matching 'lists several specific actions; minor gaps in coverage'. It falls short of anchor 5 because coverage is not comprehensive (e.g., what the sweep does with entries that pass verification, or how 'drift' is detected) and the opener 'Periodic trust sweep' is partially abstract.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'Periodic' weakly implies a schedule but never states when Claude should invoke the skill, and the judging guideline caps completeness at 3 in that case. Not anchor 4, which requires both what and when with the 'when' merely under-specified.

3 / 5

Trigger Term Quality

Relevant keywords exist ('persistent memory', 'archiving', 'verified', 'confidence') but common natural phrases users would say — 'clean up memory', 'check if memories are still true', 'stale notes' — are missing, and 'trust sweep' and 'durable knowledge notes' are invented jargon rather than user vocabulary. This matches 'some relevant keywords but missing common variations or synonyms', not anchor 4 which requires good coverage of natural terms.

3 / 5

Distinctiveness Conflict Risk

The niche — re-verifying persistent memory/knowledge notes against the live environment — is fairly distinct, matching 'mostly distinct; minor overlap risk with closely related skills' (e.g., generic memory-keeping or note-writing skills). It does not reach anchor 5 because the description lacks distinct trigger phrases, and terms like 'knowledge notes' could overlap with broader memory-management skills.

4 / 5

Total

14

/

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

huytieu/COG-second-brain

Path

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