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

60%

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

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 is a well-structured, highly actionable instruction skill with concrete script invocations, templates, and clear workflow gates. Its main weakness is verbosity in the motivational/philosophy sections that adds tokens without adding executable guidance.

Suggestions

Condense the 'Teaching Philosophy', 'What Makes Great Teaching', and 'Tutorial Writing Style' sections into a tight bullet list; drop the named-educator and company comparisons.

Consider moving the spaced-repetition interval table and quiz scoring rubric into a reference file referenced from SKILL.md to slim the overview.

Add an explicit verification step after create_tutorial.py (e.g. confirm the template file was written before editing) to strengthen workflow checkpoints.

Dimension	Reasoning	Score
Conciseness	Mostly efficient procedural guidance, but aspirational padding ('top 1% programmer', '37 Signals or Vercel', 'Julia Evans, Dan Abramov') and repeated philosophy sections ('Teaching Philosophy', 'What Makes Great Teaching', 'Tutorial Writing Style') could be tightened without losing the actionable core.	3 / 5
Actionability	Provides concrete, copy-paste-ready commands for all four scripts (setup_tutorials.py, index_tutorials.py, create_tutorial.py with exact args, quiz_priority.py), a full YAML frontmatter template, and a 1-10 quiz scoring rubric — minor gaps only.	4 / 5
Workflow Clarity	Clear sequence (welcome -> setup -> onboarding interview -> plan -> approval gate -> tutorial creation -> living tutorial -> quiz mode) with explicit checkpoints ('Wait for each answer', 'proceed only if the user approves', quiz scoring gates); minor validation gaps around file-state assumptions.	4 / 5
Progressive Disclosure	Well-organized into clear sections with four real, correctly-referenced bundle scripts in ./scripts; all guidance is one level deep with no nested references. Some detailed guidance (spaced-repetition intervals, quiz rubric) is inlined rather than split out, keeping it just below a 5.	4 / 5
	Total	15 / 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 conveys a clear, distinctive purpose but writes in second person, omits an explicit 'Use when...' trigger clause, and includes a misspelling. These keep it at the midpoint rather than the top anchors.

Suggestions

Rewrite in third person (e.g. 'Creates personalized coding tutorials...') and remove second-person 'your' to recover the specificity penalty.

Add an explicit trigger clause such as 'Use when the user asks to learn a coding concept, wants a coding tutorial, or requests a quiz / spaced-repetition review.'

Fix the misspelling 'quizes' to 'quizzes' and surface natural trigger phrases like 'teach me' and 'quiz me'.

Dimension	Reasoning	Score
Specificity	Lists several actions ('build on your existing knowledge', 'use your actual codebase for examples', 'persistent learning trail', 'spaced repetition and quizes') but they lean abstract; second-person voice ('your') triggers the -1 specificity penalty per guidelines, bringing a base of 4 down to 3.	3 / 5
Completeness	Clearly states what the skill does (personalized tutorials, codebase examples, spaced-repetition quizzes) but provides no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the rubric.	3 / 5
Trigger Term Quality	Contains relevant keywords ('coding tutorials', 'quizes') but misses the natural trigger phrases a user would actually say like 'teach me', 'learn programming', or 'quiz me', and the misspelling weakens keyword match.	3 / 5
Distinctiveness Conflict Risk	The persistent-learning-trail plus spaced-repetition quiz framing carves a fairly distinct niche with only minor overlap risk against general coding-assistant skills.	4 / 5
	Total	13 / 20 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: d5ae560

Reviewed: 1 day 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.