coding-tutor

Personalized coding tutorials that build on your existing knowledge and use your actual codebase for examples. Creates a persistent learning trail that compounds over time using the power of AI, spaced repetition and quizes.

1.91x

Quality

58%

Does it follow best practices?

Impact

94%

1.91x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./bundled/skills/coding-tutor/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a strong, actionable skill body with concrete commands, templates, and a clear gated workflow; its main weaknesses are editorial verbosity and a monolithic structure that could benefit from one-level-deep reference files.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and avoids explaining basic programming concepts Claude already knows, but it carries aspirational/editorial padding ("make you a top 1% programmer", "on par with engineers at companies like 37 Signals or Vercel", "feel like Julia Evans or Dan Abramov is their private tutor") that could be trimmed.	2 / 3
Actionability	It provides concrete, copy-paste-ready commands for all four scripts (with exact arguments), complete tutorial and profile frontmatter templates, and an explicit 1-10 quiz scoring rubric with recording format.	3 / 3
Workflow Clarity	The onboarding → plan → approval → creation → quiz flow is clearly sequenced, with a checklist for planning and an explicit approval gate plus rejection feedback loop ("If the user rejects, create a new plan"); operations are non-destructive so the missing-validation cap does not apply.	3 / 3
Progressive Disclosure	Sections are well-organized and the four scripts are correctly externalized, but the ~210-line body is monolithic with no reference markdown files for guidance (quiz rubric, tutorial template, teaching philosophy) that could be split out one level deep.	2 / 3
	Total	10 / 12 Passed

Description

40%

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 conveys a clear, distinctive purpose but is weakened by second-person voice, buzzword padding, and the complete absence of an explicit "when to use" trigger clause. It reads more as marketing copy than a precise routing signal.

Suggestions

Rewrite in third person and add an explicit trigger clause, e.g. "Creates personalized coding tutorials anchored to the user's codebase and tracks mastery with spaced-repetition quizzes. Use when the user asks to learn a concept, says 'teach me', or wants to be quizzed on prior material."

Remove fluffy phrasing ("using the power of AI", "compounds over time", "top 1% programmer" framing) so concrete capabilities stand out.

Surface the natural trigger phrases users actually say ("teach me something", "learn X", "quiz me on Y") that the skill body already uses via /teach-me and /quiz-me.

Dimension	Reasoning	Score
Specificity	The description lists several capabilities ("coding tutorials", "use your actual codebase for examples", "persistent learning trail", "spaced repetition and quizes") but pads them with fluff ("using the power of AI", "compounds over time"); additionally the second-person voice ("your existing knowledge", "your actual codebase") triggers the -1 specificity penalty per the judging guidelines.	1 / 3
Completeness	It clearly answers what the skill does but provides no "Use when…" clause or equivalent explicit trigger guidance, which caps completeness at 2 per the guidelines.	2 / 3
Trigger Term Quality	It includes some natural terms ("coding tutorials", "quizzes") but misses the common phrasings a user would actually say ("teach me", "learn", "quiz me"), and "spaced repetition" leans toward technical jargon rather than user vocabulary.	2 / 3
Distinctiveness Conflict Risk	The combination of personalization, codebase examples, and spaced repetition is a distinct niche, but the absence of explicit triggers means it could still overlap with generic coding-explanation assistance.	2 / 3
	Total	7 / 12 Passed

Validation

100%

Warnings & errors only

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: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/coding-tutor/SKILL.md
Commit: f627ab5

Reviewed: about 9 hours ago

Table of Contents

Discovery Implementation Validation

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.