CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

learn

Learn any topic properly — first-principles curriculum, generation-first tutoring, verified free recall, FSRS scheduling. Use when the user wants to learn, understand, study, or continue studying something.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

This is a highly actionable, well-sequenced workflow skill with strong validation checkpoints and copy-paste commands. Its weaknesses are token-heavy version-history prose that hurts conciseness, and inlined policy plus unverifiable external references that leave progressive disclosure mid-range.

Suggestions

Move the capstone/version-history narratives and inlined stash JSON schemas into the referenced grammar/docs files, keeping SKILL.md as a sequenced overview, to improve both conciseness and progressive disclosure.

Trim release-archaeology prose ("For four releases this section said…", issue-number citations) to the load-bearing rule only.

If the referenced `skills/_shared/*` and `docs/*` files belong to the skill, include them in a references/ bundle so the one-level-deep references are real and navigable.

DimensionReasoningScore

Conciseness

The body is dense and free of basic-concept padding, but it carries substantial version-archaeology prose and parenthetical issue citations (e.g., the v0.8 capstone narrative, "For four releases this section said…") that could be trimmed without losing instruction.

3 / 5

Actionability

It provides copy-paste-ready commands (`python3 "$ENGRAM" …`), exact stash JSON templates with required fields, and specific flags covering the common encode/verify/capstone cases — fully executable guidance.

5 / 5

Workflow Clarity

Sections 0–7 are clearly sequenced with explicit validation checkpoints (fail-closed engine resolution, sid idempotency check before apply, probe_gap repair loop, settle-stash-before-capstone) and feedback loops for error recovery.

5 / 5

Progressive Disclosure

Section headers give structure and references to grammar/docs files are one level deep, but no bundle files exist in this skill, the referenced paths live outside the bundle and are unverifiable, and substantial policy/JSON schemas are inlined rather than split into the referenced files.

3 / 5

Total

16

/

20

Passed

Description

83%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 is strong: it pairs a concrete capability list with an explicit, naturally-worded trigger clause answering both what and when. Its only weakness is moderate breadth and a few missing everyday synonyms, which keep trigger quality and distinctiveness just below the top.

DimensionReasoningScore

Specificity

Names several concrete capabilities — "first-principles curriculum, generation-first tutoring, verified free recall, FSRS scheduling" — but the actions are pedagogical mechanisms rather than the fully concrete file-level operations of the 5 anchor, leaving a minor coverage gap.

4 / 5

Completeness

It explicitly answers both what (the four mechanisms) and when ("Use when the user wants to learn, understand, study, or continue studying something") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

"Use when the user wants to learn, understand, study, or continue studying something" gives good natural-term coverage including the "continue" variant, but omits common synonyms like review, practice, or memorize that a learner might say.

4 / 5

Distinctiveness Conflict Risk

"Learn any topic" is broad but the FSRS-scheduling and free-recall framing is a clear niche; minor overlap risk remains with a generic explain/tutor skill.

4 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

nagisanzenin/engram

Path

skills/learn/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.