CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

guided-learning

AI-Guided Learning mentor. Guides the user step-by-step to build and learn a new technology without writing the final code for them.

Quality

69%

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

Quality

Content

73%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 is a strongly actionable, well-sequenced mentor workflow with explicit validation gates, an error-recovery ladder, and a per-task checklist — exemplary on workflow clarity. Its main weaknesses are repetition of the SDLC plan-check rules across three sections and some rhetorical padding, plus the absence of a worked example that could live in a reference file.

Suggestions

Consolidate the three overlapping plan-check rules (mode detection rule 2, the Standalone Invocation Rule, and the Pre-Step) into a single location to remove redundancy and tighten the token budget.

Trim directive 3's "God-Tier Autonomous Engineer" analogy down to the operative rule: perform the same spec/architecture analysis as an execution agent, only the output mechanism differs.

Move a worked example of one full task instruction (header plus all seven mandatory elements) into a references/ file and link to it, both slimming SKILL.md and giving a concrete model of the expected output format.

DimensionReasoningScore

Conciseness

The body does not explain concepts Claude already knows and is mostly operational, but the SDLC plan-check rules are repeated across three places (mode detection rule 2, the Standalone Invocation Rule, and the Pre-Step), and directive 3's "God-Tier Autonomous Engineer" / "same analytical brain" framing is padded flourish. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than level 4, where such instances would be minor.

3 / 5

Actionability

Concrete, executable guidance throughout: exact reply scripts, a standardized task-header template ("### 🎯 [Task X/Y] <Task Title>"), a surgical insertion example ("In `src/services/auth.js`, inside `AuthService`, add the following method below `login()`"), and exact verification commands ("npm test -- --grep 'AuthService'"). Not level 5 because no worked example demonstrates one complete task instruction containing all seven mandatory elements, leaving the most common output format shown only as a template.

4 / 5

Workflow Clarity

The multi-step process is explicitly sequenced (Pre-Step, Steps 1-6) with validation gates ("Only move to the next phase when the current one compiles, runs, and passes its tests"), a three-level error-recovery feedback loop (the Debugging Ladder), and a checklist of seven mandatory per-task elements. Not level 4, since that anchor requires 'minor validation gaps' and every stage here has an explicit checkpoint or wait-for-confirmation rule.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers, all content sits at one level, and nothing is buried or nested. Not level 5: the body exceeds the ~50-line simple-skill threshold with no bundle files, and a worked example task or a guide-document template would fit better in a references/ file to slim the main skill. Not level 3: no large inline block clearly belongs in a separate file — the inline content is per-invocation operational guidance.

4 / 5

Total

16

/

20

Passed

Description

50%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 states a clear, third-person 'what' with one genuinely distinctive constraint (guiding without writing the code), but it completely lacks a 'when to use' clause and misses the natural trigger phrases a user would say. It reads as a competent one-sentence summary rather than a complete routing description.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user says 'teach me X', 'walk me through building Y', 'I want to learn X by building Y', or asks for a hands-on/tutorial-style project."

Include natural synonyms such as "tutorial", "hands-on project", and "pair-programming style guidance" so the description matches how users actually phrase learning requests.

State the complementary boundary ("for direct code implementation, use a code-writing skill instead") to sharpen distinctiveness and reduce conflict with general coding/teaching skills.

DimensionReasoningScore

Specificity

"Guides the user step-by-step to build and learn a new technology" names the domain and one concrete action, with a distinguishing constraint ("without writing the final code for them"), but does not enumerate several specific capabilities — matching the anchor for domain plus 1-2 concrete actions. It is not level 4 because no list of specific actions is given, and not level 2 because the stated action is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (step-by-step guidance for building and learning a technology without writing the code for the user), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It cannot be 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Relevant keywords like "learn", "build", "step-by-step", and "guided" appear, but common natural phrases users actually say ("teach me", "walk me through", "tutorial", "hands-on") are absent. This sits at 'some relevant keywords but missing common variations or synonyms' rather than level 4, where only a few natural terms would be missing.

3 / 5

Distinctiveness Conflict Risk

The constraint "without writing the final code for them" differentiates it from code-writing skills, but "learn a new technology" is broad and overlaps with general teaching/explanation behavior, so it 'could still overlap with similar skills'. Not level 4: without explicit trigger phrasing, ordinary learning/tutorial requests could route here indiscriminately.

3 / 5

Total

12

/

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

glenrioariesto/social-content-studio

Path

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