CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

learn

Use when implementing a feature and want to understand the code as it's built - during onboarding, teaching, or learning a new pattern.

Quality

70%

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

Quality

Content

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

The body delivers a clear, well-sequenced teaching workflow with concrete output templates and a worked example, and it is appropriately actionable for an instruction-only skill. Its main weaknesses are redundant specification of the output format across three sections and no explicit feedback loop for adapting to a struggling learner.

DimensionReasoningScore

Conciseness

Output structure is specified redundantly in three places (the Step 3/6 templates, the 'Output Format' section, and the ~40-line 'Example Session'), which could be consolidated. Fits anchor 3 ('mostly efficient but could be tightened'); not 2 because there is no padding explaining concepts Claude already knows — the templates are the skill's payload.

3 / 5

Actionability

Concrete markdown templates per step, a worked TypeScript example ('types-first development', interface User), and explicit Do/Don't lists give executable guidance. Not 5 because the templates are placeholder-driven and give no concrete guidance on pacing or depth per response.

4 / 5

Workflow Clarity

Steps 1-6 are clearly sequenced (Context, Architecture, Incremental Implementation, Patterns, Gotchas, Summary) with learner-engagement checkpoints ('Try it yourself', 'What would happen if...'). Not 5 because there is no explicit feedback loop for adapting when a learner is confused; the destructive/batch cap does not apply to this teaching skill.

4 / 5

Progressive Disclosure

A single-file skill with a well-organized heading hierarchy and no buried content; the Example Session and output templates could arguably live in a references file, a minor placement gap. Fits anchor 4 ('good structure; most content appropriately placed; minor organization gaps').

4 / 5

Total

15

/

20

Passed

Description

61%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 has a strong, explicit trigger clause with natural keywords for onboarding/teaching/learning contexts, but it describes almost no concrete capabilities — the 'what' is thin and generic. Its broad 'implementing a feature' trigger also creates overlap risk with ordinary implementation sessions.

Suggestions

Lead with a concrete 'what' statement of capabilities, e.g. 'Implements a feature incrementally while explaining the concepts, patterns, and design decisions behind each piece of code', followed by the existing 'Use when...' clause.

Add concrete action verbs to the capability statement (explain architecture, show wrong approaches, provide practice exercises) so the description reflects what the skill actually does rather than only when to use it.

Sharpen the trigger to reduce conflict with plain implementation requests, e.g. 'Use when the user wants to learn while building - e.g. onboarding to a codebase, being taught a pattern, or asking to understand the code as it's written.'

DimensionReasoningScore

Specificity

The description names the domain ("implementing a feature", "understand the code as it's built") but contains no concrete capability verbs — it never states that the skill explains concepts, patterns, or decisions. This matches anchor 2 ('names the domain but actions are minimal or generic'), and not anchor 3 because 'implementing a feature' is generic rather than a concrete action.

2 / 5

Completeness

A clear, explicit 'when' clause with concrete contexts ("during onboarding, teaching, or learning a new pattern") is present, and the 'what' (implement a feature while understanding the code) is implied. Not 5 because the 'what' is folded into the 'when' and never stated as concrete capabilities; not 3 because the 'when' is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Phrases like "implementing a feature", "onboarding", "teaching", and "learning a new pattern" are natural terms users would say when they need this skill. Not 5 because common variants such as 'explain as you go', 'walk me through', or 'teach me' are missing.

4 / 5

Distinctiveness Conflict Risk

"implementing a feature" is broad enough to overlap with general coding/implementation skills, and sibling explanation or code-teaching skills could also match. The learning qualifier narrows it somewhat, fitting anchor 3 ('somewhat specific but could still overlap with similar skills').

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

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.