CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

72

Quality

90%

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

The canonical home for this skill is scaffold-exercises in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A highly actionable, workflow-driven skill body with executable commands, a full worked example, and an explicit lint-and-iterate validation loop. Its only real weakness is mild redundancy between the lint rules summary and the earlier requirement sections.

Suggestions

Consolidate the overlapping requirements stated in 'Exercise variants'/'Required files' and the 'Lint rules summary' into a single authoritative section to trim duplicated guidance.

Move the full lint-rules digest into a references/ file (e.g., lint-rules.md) and keep only the rules needed for stubbing inline, improving token efficiency when the skill body is loaded.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanations of concepts Claude already knows, but the 'Lint rules summary' partially restates requirements already covered in 'Exercise variants' and 'Required files' (e.g., non-empty readme.md, subfolder rules), so it matches anchor 4's 'minor instances that could be trimmed' rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Fully executable guidance: copy-paste-ready 'mkdir -p' commands with brace expansion, a 'git mv' example, the exact lint command 'pnpm ai-hero-cli internal lint', a readme stub template, and a complete worked plan-to-commands example, matching anchor 5.

5 / 5

Workflow Clarity

The workflow has a clear sequence (parse plan, create directories, stub readmes, run lint) with an explicit validation step and feedback loop ('Fix any errors - iterate until lint passes'), plus re-running lint after moves — matching anchor 5 for this batch operation.

5 / 5

Progressive Disclosure

Well-organized sections with all content appropriately inline for a single-workflow skill, but at ~107 lines it exceeds the under-50-line simple-skill case and contains a lint-rules digest that could live in a reference file, matching anchor 4's 'good structure; minor organization gaps' rather than anchor 5.

4 / 5

Total

18

/

20

Passed

Description

87%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 that pairs a concrete, specific 'what' with an explicit 'Use when' clause containing natural trigger phrases. Its only weaknesses are minor coverage gaps in the capability list and some missing synonym variations in the triggers.

DimensionReasoningScore

Specificity

The description lists several concrete actions and artifacts — 'Create exercise directory structures with sections, problems, solutions, and explainers that pass linting' — leaving only minor coverage gaps (e.g., moving/renaming exercises covered in the body is absent), which matches anchor 4 rather than anchor 3's '1-2 concrete actions.'

4 / 5

Completeness

It explicitly answers both what ('Create exercise directory structures with sections, problems, solutions, and explainers that pass linting') and when ('Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section') with concrete trigger phrases, matching anchor 5 exactly.

5 / 5

Trigger Term Quality

'scaffold exercises, create exercise stubs, or set up a new course section' are natural phrases a user would say, giving good keyword coverage, but common synonyms (e.g., 'new exercise', 'course module') are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Course-exercise scaffolding is a clear niche with distinct triggers ('scaffold exercises', 'exercise stubs', 'new course section') and minimal overlap risk with other skills, matching anchor 5 rather than anchor 4's 'minor overlap risk with closely related skills.'

5 / 5

Total

18

/

20

Passed

Validation

100%

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

SnowingFox/ai-skills

Path

.cursor/skills/scaffold-exercises/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.