CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

learning-opportunities

Facilitates deliberate skill development during AI-assisted coding. Offers interactive learning exercises after architectural work (new files, schema changes, refactors). Use when completing features, making design decisions, or when user asks to understand code better. Triggers on "learning exercise", "help me understand", "teach me", "why does this work", or after creating new files/modules. Do NOT use for urgent debugging, quick fixes, or when user says "just ship it".

Quality

91%

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

92%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 strong, tightly written instruction skill. It provides copy-paste-ready phrasings, an unambiguous offer/respond workflow with explicit stop-and-wait checkpoints, and clean progressive disclosure to a verified one-level-deep reference. The only improvement space is trimming small redundancies in the example dialogues.

DimensionReasoningScore

Conciseness

The body is efficient, assumes Claude's competence (no explanations of concepts Claude already knows), and every section carries actionable guidance. Minor trimmable instances remain: the 'This is the most important rule' flourish, and three example dialogues that each re-demonstrate the [STOP — wait for response] pattern already established in the 'Pause for input' section. Anchor 4, not 5, because of this small amount of redundancy.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: verbatim offer phrasing ("Would you like to do a quick learning exercise on [topic]? About 10-15 minutes."), explicit allowed/disallowed follow-ups, concrete example dialogues for each exercise type, and graduated prompt examples ("Open src/middleware/auth.ts, around line 45" → "Find where we handle token refresh" → "Where would you look..."). The scoring note confirms instruction-only skills without code are not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced: when to offer / when not to offer → offer with exact phrasing (one sentence, no insistence) → pose question → [STOP — wait for response] → branch on correct vs. wrong with explicit responses. The [STOP] markers are explicit checkpoints and the if-correct/if-wrong branches are feedback loops. This is not a destructive or batch skill, so no validation cap applies.

5 / 5

Progressive Disclosure

The body is a well-organized overview with clear sections, and it delegates the underlying learning science to a single, clearly signaled, one-level-deep reference: "consult references/PRINCIPLES.md for the underlying learning science" — a real file that contains supporting principles and sources rather than instructions. The split is appropriate: operational guidance lives in SKILL.md, rationale lives in the reference, and navigation is easy.

5 / 5

Total

19

/

20

Passed

Description

86%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 well-constructed description with an explicit what/when structure, quoted natural trigger phrases, and useful negative triggers. Its main weakness is that the capability statement remains somewhat abstract — it says exercises are offered but not what kinds of exercises or techniques the skill provides.

Suggestions

Replace the abstract 'Facilitates deliberate skill development' lead with the concrete exercise types the skill actually offers (e.g., predict-then-observe, generate-then-compare, teach-it-back) so the what enumerates several specific actions.

Narrow the broad triggers 'help me understand' and 'teach me' to the skill's niche (e.g., 'teach me how this code we just built works') to reduce overlap with general code-explanation skills.

DimensionReasoningScore

Specificity

The description names the domain ("AI-assisted coding" skill development) and 1-2 concrete actions ("Offers interactive learning exercises after architectural work (new files, schema changes, refactors)"), but the core capability statement "Facilitates deliberate skill development" is abstract and the exercise types/techniques are never enumerated. It sits at anchor 3 (domain + 1-2 concrete actions, not comprehensive), not 4, which requires several specific actions listed.

3 / 5

Completeness

It explicitly answers both questions: the what ("Facilitates deliberate skill development... Offers interactive learning exercises after architectural work") and the when ("Use when completing features, making design decisions, or when user asks to understand code better. Triggers on...") with concrete trigger phrases, plus explicit exclusions ("Do NOT use for urgent debugging, quick fixes..."). This matches the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Multiple verbatim natural phrases users would actually say are quoted as triggers: "learning exercise", "help me understand", "teach me", "why does this work", plus scenario triggers ("completing features", "making design decisions", "creating new files/modules") and natural negative triggers ("just ship it"). Coverage is comprehensive; no obvious natural variants are missing.

5 / 5

Distinctiveness Conflict Risk

The niche (post-work learning exercises) is mostly distinct, aided by negative triggers ("Do NOT use for urgent debugging, quick fixes, or when user says 'just ship it'"), but broad triggers like "help me understand" and "teach me" could overlap with general code-explanation skills. Minor overlap risk with closely related skills — anchor 4, not 5.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tech-leads-club/agent-skills

Path

packages/skills-catalog/skills/(learning)/learning-opportunities/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.