CtrlK
BlogDocsLog inGet started
Tessl Logo

working-memory-protocol

Use when deciding what to record with working_memory_note, when the user says "remember this" or corrects you, or when a Crystal Pointer matches the topic. Not for answering from memory (use memory_search).

63

Quality

76%

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

Quality

Content

78%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 compact, well-structured protocol skill: it gives concrete trigger conditions, a fully enumerated type parameter with examples, and explicit edge-case rules without any padding or generic explanations. The only meaningful gaps are the absence of a sample working_memory_note invocation and a slightly over-detailed MEMORY.md taxonomy that could be trimmed to the bullets actually used.

Suggestions

Add a short example working_memory_note call (with a type argument) so the exact invocation format is copy-paste ready.

Trim the MEMORY.md taxonomy bullets to those the protocol actually uses (notably Crystal Pointers and Active Context) to save tokens.

State a one-line tie-break rule for when multiple triggers or types apply (e.g., prefer directive over experience for corrections).

DimensionReasoningScore

Conciseness

The body is lean with no padding and no explanations of concepts Claude already knows — the dream engine and MEMORY.md structure are bespoke system context, not general knowledge. The 7-bullet MEMORY.md taxonomy is partially dispensable (only 'Crystal Pointers' is referenced later), which keeps it below anchor 5, but each bullet is a compact one-liner earning partial relevance, matching anchor 4's 'minor instances of over-explanation'.

4 / 5

Actionability

Concrete, executable guidance throughout: specific trigger conditions, the full `type` parameter enumeration with inline examples ('I prefer X', 'always do Y', 'never Z'), the Crystal Pointer line syntax (`-> search: \`keywords\``), and the target file `memory/scratch.md`. It stops short of anchor 5 only because it lacks an example `working_memory_note` call showing the exact invocation format.

4 / 5

Workflow Clarity

A simple decision-protocol skill with unambiguous if-then rules: triggers for noting, type selection with a stated default (`experience`), and explicit edge-case handling for Crystal Pointer recall and profile corrections. No destructive or batch operations, so no validation cap applies; it misses anchor 5 only because no explicit ordering is given for cases where multiple triggers or types could apply.

4 / 5

Progressive Disclosure

Under 50 lines with no need for external reference files, and the content is cleanly sectioned with descriptive headers ('When to use working_memory_note', 'Epistemic type parameter', 'Crystal Pointers', 'Correcting the user profile'). Per the rubric's simple-skill note, well-organized sections alone warrant a 5 here; there are no bundle files, so there is nothing to over- or under-disclose.

5 / 5

Total

17

/

20

Passed

Description

73%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, well-scoped description with explicit trigger guidance and an unusually good negative boundary that prevents mis-triggering against memory_search. Its main weakness is the thin 'what': it states the decision role but not the concrete recordable content types, which keeps specificity and completeness in the mid range.

Suggestions

Enumerate 2-3 concrete recordable content types in the description (e.g., 'Record user preferences, corrections, decisions, and key facts') to lift specificity from one action to several.

Add one or two natural trigger synonyms such as 'note this' or 'don't forget' to broaden trigger term coverage.

Consider naming the default behavior or the type parameter briefly so the 'what' half answers what the skill does with what it records.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action ('deciding what to record with working_memory_note') but does not enumerate the several specific capabilities (recording preferences, corrections, facts, decisions). It fits anchor 3 — domain plus 1-2 concrete actions, not comprehensive — better than anchor 4, which requires several listed specific actions.

3 / 5

Completeness

Both what ('deciding what to record with working_memory_note') and when (explicit 'Use when...' with three concrete triggers) are present. The 'when' clause is highly explicit, but the 'what' is a single decision action that never states what kinds of content get recorded, leaving it just short of anchor 5's clearly-and-fully-specified both.

4 / 5

Trigger Term Quality

Includes natural phrases users would actually say ('remember this', 'corrects you') plus a domain trigger ('Crystal Pointer matches the topic'), and the negative boundary 'Not for answering from memory' aids routing. A few natural variations are missing (e.g., 'note this', 'don't forget'), so it falls just below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche tied to a named tool (working_memory_note) with distinct triggers, and the explicit exclusion 'Not for answering from memory (use memory_search)' pre-empts confusion with the nearest competing skill. Minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
Bitterbot-AI/bitterbot-desktop
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.