CtrlK
BlogDocsLog inGet started
Tessl Logo

capture-learnings

Capture and apply accumulated knowledge via structured memory. Use when the user gives feedback, shares preferences, corrects a mistake, or when you discover something worth remembering for future conversations.

64

Quality

80%

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

Quality

Content

75%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-organized, actionable instruction-only skill: exact tool commands, a concrete scope model, and read-before-write discipline throughout. Its weaknesses are modest — a missing invocation example for the shared-scope `resources` write, some repetition between the Key Rules and earlier sections, and a trigger catalog that could be split into a reference file.

Suggestions

Add the exact invocation for the shared-scope write, e.g. a one-line example of the `resources` tool call with `scope: "shared"` and the `LEARNINGS.md` path, mirroring the `save-memory` examples.

Trim Key Rules 2 and 4 (scope-by-audience and read-before-update), which restate the 'How to Read & Write Memories' and 'When to Capture' sections, or fold those sections' detail into the rules to remove the duplication.

Consider moving the ~45-line 'When to Capture' example catalog (user preferences, feedback, project, reference bullets) into a one-level-deep reference file, keeping only the shared-scope guidance and Don't-Capture list inline.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it teaches the tool-specific resource model and scope rules rather than general concepts, and the Memory Types table is dense information per token. There is minor redundancy that could be trimmed: Key Rules 2 and 4 restate guidance already given in 'How to Read & Write Memories' and 'When to Capture', and some example quotes in the capture lists are near-tautological. Not 'lean, every token earns its place' (5), but well above 'noticeably verbose' (2) or 'mostly efficient with unnecessary explanation' (3).

4 / 5

Actionability

Concrete, copy-paste-ready commands are given for personal memory operations ('save-memory --name <name> --type <type> --description "..." --content "..."', 'resource-read --path memory/<name>.md', 'delete-memory --name <name>', 'resource-list --prefix memory/') plus a concrete types table and scope rule. The one notable gap is the shared-scope write: 'write the full updated file with the `resources` tool using `scope: "shared"`' names the tool but never shows its invocation syntax, leaving that step executable only by inference — that keeps it below fully-executable level 5.

4 / 5

Workflow Clarity

The workflow is clearly sequenced with the important checkpoints present: read-first/merge-don't-overwrite before updating, 'Save only new, supported facts' as a gate, and scope selection by audience before writing. Memory writes are not batch/destructive operations requiring validate-fix-retry loops, so the level 3 cap does not apply. It stops short of level 5 because there is no post-write verification (e.g., re-reading to confirm the merge) and the shared LEARNINGS.md update path is described only in prose.

4 / 5

Progressive Disclosure

No bundle files exist, so this is scored on the body's own structure: clear section headers, a scannable types table, and well-organized capture guidance that is easy to navigate — matching 'good structure, most content appropriately placed'. It is not a level 5 because the 'When to Capture' subsections (team knowledge, preference examples, don't-capture list) run ~45 lines of trigger catalog that could plausibly live in a one-level-deep reference file, and the ~90-line body exceeds the simple-skill threshold where organization alone earns a 5.

4 / 5

Total

16

/

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 in third-person voice with an explicit and concrete 'Use when' trigger clause that fully answers both what and when. Its main weakness is that the capability statement stays at two generic verbs, so it under-sells the specific operations the skill performs.

Suggestions

Expand the 'what' clause with 1-2 more concrete operations, e.g. 'Capture, merge, and retrieve accumulated knowledge via a structured personal and team memory (save, read, update, index)'.

Add common user phrasings as triggers, such as 'remember this', 'keep that in mind', or 'don't forget', to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description names its domain ('structured memory') and two concrete actions ('Capture and apply accumulated knowledge'), which matches the anchor for 1-2 concrete actions without comprehensive coverage. It does not enumerate what capture involves (saving, merging, reading, indexing), so it falls below the 'several specific actions' level 4 anchor.

3 / 5

Completeness

Both halves are explicit: 'what' is 'Capture and apply accumulated knowledge via structured memory' and 'when' is the concrete 'Use when the user gives feedback, shares preferences, corrects a mistake, or when you discover something worth remembering' trigger list. This clearly matches the level 5 anchor; the level 4 anchor applies only when 'when' is less explicit, which is not the case here.

5 / 5

Trigger Term Quality

The 'Use when' clause includes natural phrases users would say — 'gives feedback, shares preferences, corrects a mistake' — giving good keyword coverage. A few common variations are missing (e.g., 'remember this', 'keep this in mind', 'don't forget'), keeping it below the comprehensive-with-synonyms level 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The memory-capture niche with triggers around feedback, preferences, and corrections is mostly distinct from document- or code-processing skills. There is minor overlap risk with general note-taking/knowledge-management skills, so it sits at 'mostly distinct' rather than the 'clear niche, minimal conflict' level 5 anchor.

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
BuilderIO/agent-native
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.