learning-tutoring

Learning tutoring planning and content production skill for creating study plans, generating exercises, writing answer explanations, and providing review/adjustment guidance; triggered by requests like “study plan”, “exercise set/question bank”, “answer analysis”, “error analysis”, “exam prep plan”, or “spaced/periodic review schedule”.

Quality

75%

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 ./scientific-skills/Other/learning-tutoring/SKILL.md

Quality

Content

53%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 actionable and well-supported by real bundle files, but suffers from duplicated boilerplate sections that hurt conciseness and a missing validation checkpoint for the batch script. Consolidating the repeated sections would materially improve it.

Suggestions

Remove the duplicated generic section block (the first When to Use / Key Features / Dependencies / Example Usage / Implementation Details pass) and keep only the specific, value-adding versions.

Add an explicit validation step to the structured batch generation workflow (e.g. verify outputs/tutoring_pack.json parses and required fields are populated before rendering).

Move the full worked 6-week example plan into references/ or trim it to a compact skeleton, keeping SKILL.md as an overview that points to references/tutoring_templates.md.

Dimension	Reasoning	Score
Conciseness	The body duplicates entire section headings (When to Use, Key Features, Dependencies, Example Usage, Implementation Details each appear twice), with the first pass being generic boilerplate (e.g. "Use this skill when a others task needs a packaged method"), making it noticeably verbose and padded.	2 / 5
Actionability	Provides a fully worked 6-week study plan, sample exercises with required fields (stem/answer/explanation/pitfall/transfer tip/difficulty/tags), and a real script invocation; minor gap is that batch use requires editing an in-file CONFIG rather than CLI args.	4 / 5
Workflow Clarity	The core workflow is sequenced with required clarifying questions and milestone acceptance criteria, but the batch script operation (build_tutoring_pack.py) has no explicit validation/verification checkpoint, capping this dimension at 3.	3 / 5
Progressive Disclosure	References are one level deep and clearly signaled ("see: references/tutoring_templates.md"; scripts/build_tutoring_pack.py) and the referenced files exist, but the duplicated top-level sections and inlined worked example leave minor organization gaps.	4 / 5
	Total	13 / 20 Passed

Description

96%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 strong, third-person description that clearly states capabilities and supplies concrete natural trigger phrases. The only weakness is slight overlap risk with broader study/academic-planning skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "creating study plans, generating exercises, writing answer explanations, and providing review/adjustment guidance" — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what it does (the four content-production actions) and when to use it ("triggered by requests like…"), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural trigger phrases users would say ("study plan", "exercise set/question bank", "answer analysis", "error analysis", "exam prep plan", "spaced/periodic review schedule") with synonyms included.	5 / 5
Distinctiveness Conflict Risk	A clear learning-tutoring niche with distinct triggers, but terms like "study plan" and "exam prep plan" carry minor overlap risk with generic academic-planning skills.	4 / 5
	Total	19 / 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/learning-tutoring/SKILL.md
Commit: f5ef65b

Reviewed: ~17 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.