CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/learning-tutoring/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 substantive half of the body is genuinely actionable — runnable commands, a real script with a documented CONFIG/outputs path, required exercise fields, and milestone-based adjustment rules. But the file is badly padded: five sections appear twice, the description is repeated three times across the file, and a full 6-week example output is inlined where a reference file belongs.

Suggestions

Delete the first (generic) set of 'When to Use', 'Key Features', 'Dependencies', 'Example Usage', and 'Implementation Details' sections — they duplicate the second set and restate the frontmatter description verbatim; keep only the specific versions.

Move the full 6-week worked example (~90 lines) into a reference file such as references/example_pack.md and keep a one-screen skeleton in SKILL.md, preserving the one-level-deep reference pattern already used for references/tutoring_templates.md.

Replace the repo-internal path 'cd "20260316/scientific-skills/Others/learning-tutoring"' with the skill's own directory, and make output validation explicit (e.g., check outputs/tutoring_pack.json covers all CONFIG topics and question-type counts before rendering the final deliverable).

DimensionReasoningScore

Conciseness

Noticeably verbose with padded sections: the top-level sections 'When to Use', 'Key Features', 'Dependencies', 'Example Usage', and 'Implementation Details' each appear twice, the frontmatter description is repeated nearly verbatim in both 'When to Use' ('Use this skill when you need learning tutoring planning and content production skill for...') and 'Key Features' ('Scope-focused workflow aligned to: Learning tutoring planning...'), and filler like 'Use this skill when a others task needs a packaged method instead of ad-hoc freeform output' and 'Structured execution path designed to keep outputs consistent and reviewable' adds no information. Not level 1 because the second half contains genuinely useful, non-obvious content (output specs, question schemas, adjustment rules); it is below level 3 because roughly 45 lines of boilerplate duplication plus a ~90-line inline example are substantial waste.

2 / 5

Actionability

Mostly executable: concrete commands ('python -m py_compile scripts/build_tutoring_pack.py', 'python scripts/build_tutoring_pack.py --help'), a real batch path ('Open and fill in CONFIG in scripts/build_tutoring_pack.py' → 'Read outputs/tutoring_pack.json' — both verified to exist in the script), a worked example with required exercise fields (Type/Stem/Answer/Explanation/Difficulty/Tags), and specific clarifying questions. Not level 5 because 'cd "20260316/scientific-skills/Others/learning-tutoring"' is a repo-internal path that is not copy-paste valid from the skill's own directory.

4 / 5

Workflow Clarity

Clear sequence: the 5-step 'Core Workflow (Execute as Needed)', 'Required Clarifying Questions (Ask if Missing)' before generation, input confirmation ('confirm the source files, scope limits, output format, and acceptance criteria before running any script'), and a concrete feedback loop ('If Week 3 accuracy on inverses <70%, reduce new content in Week 4 and add 2 extra inverse drill sessions'). Not level 5 because output validation is only implicit ('Review the generated output and return the final artifact') rather than an explicit check of the generated pack against the acceptance criteria.

4 / 5

Progressive Disclosure

References are real, one level deep, and clearly signaled ('For consistent layout and quality standards, see: references/tutoring_templates.md', which exists and matches the body's format specs) — better than buried references. However, five top-level sections are duplicated verbatim (two 'When to Use', two 'Key Features', two 'Dependencies', two 'Example Usage', two 'Implementation Details'), and a ~90-line full worked example output is inlined in SKILL.md where a shorter skeleton plus a reference file would suffice. This matches 'some structure but could be better organized; content that should be separate is inline' rather than the 'minor organization gaps' of level 4.

3 / 5

Total

13

/

20

Passed

Description

83%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 description: it states four concrete capabilities and gives explicit, natural trigger phrases in third person. The only weaknesses are a slightly generic final action ('review/adjustment guidance') and missing a few common trigger variations like 'tutoring' or 'practice questions'.

DimensionReasoningScore

Specificity

Lists four concrete actions — 'creating study plans, generating exercises, writing answer explanations, and providing review/adjustment guidance' — but 'review/adjustment guidance' is generic and the opening 'Learning tutoring planning and content production skill' is meta-padding rather than an action, leaving minor gaps in coverage. It is above level 3 (which expects only 1-2 concrete actions) but not the comprehensive, uniformly concrete coverage of level 5.

4 / 5

Completeness

Explicitly answers both what ('creating study plans, generating exercises, writing answer explanations, and providing review/adjustment guidance') and when ('triggered by requests like "study plan", ...') with concrete trigger phrases, in third person. This matches the level 5 anchor directly; level 4 would require the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Includes natural user phrases with synonyms: 'study plan', 'exercise set/question bank', 'answer analysis', 'error analysis', 'exam prep plan', 'spaced/periodic review schedule'. Common variations a user would say — 'tutoring', 'practice questions', 'homework help' — are missing, so it falls short of the comprehensive synonym coverage of level 5 but is well above the sparse keyword coverage of level 3.

4 / 5

Distinctiveness Conflict Risk

The learning/tutoring niche with triggers like 'question bank', 'exam prep plan', and 'spaced review schedule' is mostly distinct. Minor overlap risk remains: 'error analysis' and 'study plan' could also surface for generic planning or debugging-related skills. Not level 5 (which demands minimal conflict risk) but clearly above the broad overlap of level 3.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

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.