tutorial-engineer

Creates step-by-step tutorials and educational content from code. Transforms complex concepts into progressive learning experiences with hands-on examples. Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations.

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/tutorial-engineer/SKILL.md

Quality

Content

46%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 content is well-structured and covers the tutorial-engineering domain broadly, but it stays at the level of generic best-practice advice without concrete, actionable artifacts or validation checkpoints. Adding worked examples and templates would most improve its actionability and workflow clarity.

Suggestions

Add at least one concrete worked tutorial example (a real opening/progressive/closing section with runnable code) so the guidance is executable rather than descriptive.

Provide a reusable Markdown output template a learner can fill in, instead of only listing desired output-format attributes.

Insert explicit validation/checklist checkpoints into the Tutorial Development Process (e.g., verify each learning objective is met before advancing) to add the missing feedback loops.

Dimension	Reasoning	Score
Conciseness	Content is bulleted and reasonably organized, but much of it is generic pedagogical advice Claude already knows ('Show, Don't Tell', 'Use analogies', 'Multiple Perspectives'), so it is mostly efficient with some unnecessary explanation that could be tightened, matching the score-3 anchor.	3 / 5
Actionability	Guidance is largely abstract and high-level ('Create hands-on coding exercises', 'Build from simple to complex', 'Include checkpoints') with no concrete templates, worked examples, or specific commands, falling between the vague score-1 and incomplete score-3 anchors and noticeably below the midpoint.	2 / 5
Workflow Clarity	A sequenced development process and tutorial structure are present, but there are no validation checkpoints or feedback loops, matching the score-3 anchor of 'steps listed but validation gaps; checkpoints missing or implicit'.	3 / 5
Progressive Disclosure	A single well-organized SKILL.md with clear section headers and no bundle files shows good structure with only minor organization gaps (e.g., long Exercise Types/Formats lists could be split), fitting the score-4 anchor rather than 5 since it exceeds the simple-skill threshold.	4 / 5
	Total	12 / 20 Passed

Description

71%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 clearly states both what the skill does and when to use it, with explicit third-person trigger guidance. Its main weakness is limited breadth of specific capabilities and trigger synonyms, which keeps specificity and trigger-term quality at the midpoint.

Dimension	Reasoning	Score
Specificity	Names the tutorial/educational-content domain and a couple of concrete actions ('Creates step-by-step tutorials', 'Transforms complex concepts into progressive learning experiences with hands-on examples'), but coverage is narrow without enumerating multiple distinct capabilities, matching the score-3 anchor.	3 / 5
Completeness	Explicitly answers both what ('Creates step-by-step tutorials and educational content from code') and when ('Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations') with concrete trigger phrases in third person, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Includes natural triggers users would say ('onboarding guides, feature tutorials, or concept explanations'), but misses common variations/synonyms like walkthrough, how-to, lesson, or course, fitting the score-3 anchor rather than the comprehensive score-4.	3 / 5
Distinctiveness Conflict Risk	The tutorial/educational-content niche is mostly distinct, though it could overlap with general documentation or code-explanation skills, fitting the 'mostly distinct; minor overlap risk' score-4 anchor.	4 / 5
	Total	15 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: rmyndharis/antigravity-skills
Path: skills/tutorial-engineer/SKILL.md
Commit: 3eff4af

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.