CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

teach

Teach the user a new skill or concept, within this workspace.

Quality

64%

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/teach/SKILL.md

The canonical home for this skill is teach in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

61%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 thoughtfully structured, conceptually rich instruction skill: the workspace model, file conventions, and reuse rules are concrete and the pedagogy rationale is coherent. Its weaknesses are an implicit, distributed workflow (no single 'when invoked, do this in order' section), some over-explanation of concepts Claude already knows, and format references that point at files missing from the bundle.

Suggestions

Add an explicit 'When invoked' workflow section that sequences the first session: 1) read MISSION.md (question the user if unpopulated), 2) read learning-records to establish the ZPD, 3) check RESOURCES.md, 4) author/link the lesson, 5) update records and NOTES.md.

Trim explanations of concepts Claude already knows — the parentheticals on retrieval practice, spacing, and interleaving, the working-memory aside, and the ADR comparison — to bare term names or one-line pointers.

Ship the referenced MISSION-FORMAT.md, RESOURCES-FORMAT.md, and LEARNING-RECORD-FORMAT.md in the skill bundle (or inline minimal one-line formats) so the format links resolve; tighten vague directives like "open the lesson file by running a CLI command" and "Think Tufte" with a concrete command and stylesheet defaults.

DimensionReasoningScore

Conciseness

The body is well-organized but explains concepts Claude already knows: "retrieval practice (recall from memory)", "Spacing (distributing practice over time)", "Learners' working memory is very small, and we need to stay within it", and "loosely equivalent to architectural decision records". Several such parentheticals and explanatory asides could be trimmed, matching the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'). It is not the padded, tutorial-style prose of score 2, but there is more than the 'minor instances' of score 4.

3 / 5

Actionability

For an instruction-only skill the guidance is largely concrete: exact file names and roles (MISSION.md, RESOURCES.md, NOTES.md), naming conventions ("titled `0001-<dash-case-name>.md`, where the number increments each time"), directories (./lessons/, ./assets/, ./reference/), format links, and testable rules ("For quizzes, each answer should be exactly the same number of words", "never inline code a future lesson would duplicate"). This matches the score-4 anchor ('mostly executable guidance... with minor gaps'); the gaps — "open the lesson file for the user by running a CLI command" without naming a command, "beautiful... Think Tufte" with no concrete style parameters, and "short" with no length target — keep it below the copy-paste-ready specificity of score 5.

4 / 5

Workflow Clarity

The operational sequence is never laid out in one place; it is distributed across concept sections and must be inferred (check MISSION.md → read learning-records → determine ZPD → gather resources → author lesson → update records). Checkpoints exist but are implicit and scattered ("If the user is unclear about the mission... your first job should be to question the user"). This matches the score-3 anchor ('steps listed but validation gaps; sequence present but checkpoints missing or implicit') rather than score 4, which requires a clear sequence with most checkpoints explicit. No destructive/batch operations, so the workflow cap does not apply.

3 / 5

Progressive Disclosure

The body is a well-sectioned overview with clear one-level-deep, well-signaled references — "Use the format in [MISSION-FORMAT.md](./MISSION-FORMAT.md)", "[RESOURCES-FORMAT.md](./RESOURCES-FORMAT.md)", "[LEARNING-RECORD-FORMAT.md](./LEARNING-RECORD-FORMAT.md)" — and detail is appropriately delegated (formats, per-file contents) rather than inlined. This fits the score-4 anchor ('good structure; most content is appropriately placed; references mostly clear'). It falls short of score 5 because the three referenced *-FORMAT.md files are not present in the skill bundle (dead links as shipped), and the body runs ~134 lines where a tighter overview could push more detail into those referenced files.

4 / 5

Total

14

/

20

Passed

Description

53%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 clear, honest, and correctly scoped to the multi-session teaching workspace, but it is thin: a single generic action, no 'when to use' guidance, and sparse synonyms. It reads as a label rather than a trigger-rich capability statement.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to be taught or to learn a topic, especially over multiple sessions."

Enumerate the concrete actions the skill performs so the 'what' is comprehensive: e.g. "Designs interactive lessons, builds reference sheets and glossaries, and tracks learning progress across sessions."

Include natural synonym terms users would actually say — "learn", "learning", "tutor", "study", "tutorial" — to improve trigger coverage and distinctiveness versus one-off 'explain' requests.

DimensionReasoningScore

Specificity

"Teach the user a new skill or concept, within this workspace" names the domain (teaching/learning) and one concrete action with its object, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is more informative than the score-2 anchor ('Processes PDF files' — action with no object or scope) but lists only a single generic action, well short of the several specific actions at score 4.

3 / 5

Completeness

The 'what' is clear ("Teach the user a new skill or concept, within this workspace"), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This is the exact score-3 anchor: clear 'what', 'when' missing or only weakly implied (the argument-hint "What would you like to learn about?" only weakly implies an entry point).

3 / 5

Trigger Term Quality

It contains relevant natural keywords — "teach", "skill", "concept" — that a user might say ("teach me X"), but misses common variations and synonyms such as "learn", "learning", "tutorial", or "study". This fits the score-3 anchor ('some relevant keywords but missing common variations or synonyms'); it is not the near-empty keyword set of score 2, nor the comprehensive synonym coverage of score 5. Note also that model invocation is disabled, so these terms serve user-facing discovery rather than automatic triggering.

3 / 5

Distinctiveness Conflict Risk

"Teach the user a new skill or concept" carves out a recognizable teaching/tutoring niche with little overlap against typical file- or task-oriented skills. There is minor overlap risk with generic "explain X" / "help me learn X" requests that don't warrant the multi-session workspace this skill sets up — matching the score-4 anchor ('mostly distinct; minor overlap risk with closely related skills') rather than score 5's clean niche with explicit distinct triggers, since no disambiguating trigger phrases are given.

4 / 5

Total

13

/

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: 3 missing

Warning

Total

14

/

16

Passed

Repository

tonykay/transcriber

Path

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