CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lesson

Save a correction or hard-won rule as a confidence-weighted lesson that resurfaces before similar work. Use when the user corrects your approach, says "learn this", "always" or "never do X", or you notice yourself repeating a past mistake.

Quality

82%

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

81%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 tight, actionable instruction skill: concrete tool-call example with expected output, parameter heuristics, an explicit user-veto checkpoint, and WRONG/RIGHT examples that teach the rule-vs-story distinction. The notable defect is the dangling TROUBLESHOOTING.md reference — the only referenced file in the bundle doesn't exist — and slight redundancy between the Workflow and Checklist sections.

Suggestions

Ship the referenced TROUBLESHOOTING.md (e.g., in references/) or remove the Troubleshooting section: the link currently points to a file that doesn't exist anywhere in the skill bundle, so a session hitting that failure mode gets a broken pointer.

Trim the Checklist, which restates the Workflow items nearly verbatim, or fold its unique checks (no secrets, echo-back for veto) into the workflow steps to reclaim tokens.

Show the memory_lesson_recall call as a concrete example alongside the save call, mirroring the Quick start format, so the recall workflow is as executable as the save workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — the Quick start is a single tool call with expected output, and the two-sentence 'Why' explains skill-specific mechanics (confidence strengthening/decay) Claude would not know. Not a 5 because the Checklist section largely restates the Workflow steps, so those tokens are redundant trimmable material.

4 / 5

Actionability

Guidance is mostly executable: a concrete Quick start call with all parameters (content, context, confidence, project), expected output, explicit confidence heuristics (0.7 for user correction, 0.5 for self-observed), and WRONG/RIGHT content examples. Minor gaps keep it from 5: the recall and delete calls are described but never shown, and the save example uses an informal unquoted-key format rather than a precise invocation.

4 / 5

Workflow Clarity

Six clearly sequenced steps with an explicit validation checkpoint — step 6 'Confirm with the rule as saved, so the user can veto a bad distillation' — plus a reinforcing checklist and a WRONG/RIGHT contrast, matching the 5 anchor's sequence-with-explicit-validation-and-checklist pattern. The recall side is also sequenced (query by task type, ranked by confidence and recency).

5 / 5

Progressive Disclosure

Good structure for a short skill: well-organized sections with the rare failure path pushed to a clearly signaled one-level reference ('See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) if memory_lesson_save is not available'). Not a 5 because that referenced file does not exist in the bundle (no references/, scripts/, or assets/ directories and no TROUBLESHOOTING.md anywhere), leaving a dangling navigation point rather than well-signaled, resolvable references.

4 / 5

Total

17

/

20

Passed

Description

78%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: imperative verb, clear what, and an explicit 'Use when' clause with literal trigger phrases users would say. The main gap is that the capability description stays at about two abstract actions rather than enumerating the concrete save/strengthen/recall operations, and a few natural trigger synonyms are absent.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "Save a correction or hard-won rule as a confidence-weighted lesson" and "resurfaces before similar work" — but the mechanism stays abstract (no mention of how it resurfaces or the save/recall operations). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than 4, which expects several specific actions with only minor coverage gaps.

3 / 5

Completeness

It explicitly answers both questions: what ("Save a correction or hard-won rule as a confidence-weighted lesson that resurfaces before similar work") and when ("Use when the user corrects your approach, says 'learn this', 'always' or 'never do X', or you notice yourself repeating a past mistake"). This mirrors the 5-anchor example's what-plus-concrete-trigger-phrase structure; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It quotes natural phrases users actually say — "says 'learn this', 'always' or 'never do X'", "the user corrects your approach", "repeating a past mistake" — giving good keyword coverage. Not a 5 because common variants like "remember this", "don't do that again", or "next time" are missing.

4 / 5

Distinctiveness Conflict Risk

The "confidence-weighted lesson" framing and correction-focused triggers carve a fairly distinct niche, but phrases like "learn this" could plausibly also invoke a general memory/remember skill, so minor overlap risk with closely related skills remains — a 4, not the clear-distinct-triggers 5.

4 / 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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

rohitg00/agentmemory

Path

plugin/skills/lesson/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.