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.

Quality

96%

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

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

Quality

Content

92%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality skill that provides clear, actionable guidance for scaffolding exercise directories. It excels at conciseness and actionability with concrete bash commands, specific file content examples, and a complete end-to-end example. The workflow includes proper validation checkpoints with lint iteration, and the content is well-organized, though it could benefit from extracting the lint rules summary to a separate reference file for better progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient. Every section serves a purpose—naming conventions, required files, lint rules, workflow steps, and a concrete example. No unnecessary explanations of basic concepts; it assumes Claude knows how to use bash, markdown, and git.	3 / 3
Actionability	Provides fully executable bash commands (mkdir -p, git mv), concrete file content examples, specific lint commands, and a complete end-to-end example showing how to go from a plan to directory structure with readme stubs. Everything is copy-paste ready.	3 / 3
Workflow Clarity	The workflow section provides a clear 5-step sequence with an explicit validation checkpoint (run lint) and a feedback loop (fix any errors, iterate until lint passes). The moving/renaming section also includes a re-run lint step after changes.	3 / 3
Progressive Disclosure	The content is well-organized with clear section headers and logical flow from naming conventions to workflow to examples. However, for a skill of this length (~90 lines of substantive content), the lint rules summary could potentially be extracted to a reference file. The structure is good but not optimal—it's all inline with no references to supporting files.	2 / 3
	Total	11 / 12 Passed

Description

100%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly communicates what the skill does (creates exercise directory structures with specific components) and when to use it (scaffolding exercises, creating stubs, setting up course sections). It uses third person voice, includes natural trigger terms, and occupies a distinct niche that minimizes conflict risk with other skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'Create exercise directory structures with sections, problems, solutions, and explainers that pass linting.' This clearly describes the structural components involved.	3 / 3
Completeness	Clearly answers both 'what' (create exercise directory structures with sections, problems, solutions, and explainers that pass linting) and 'when' (explicit 'Use when' clause with three trigger scenarios: scaffold exercises, create exercise stubs, set up a new course section).	3 / 3
Trigger Term Quality	Includes natural trigger terms users would say: 'scaffold exercises', 'create exercise stubs', 'set up a new course section', 'exercise directory structures', 'sections', 'problems', 'solutions'. These cover common variations of how a user would request this.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive niche — exercise directory structures with specific components (sections, problems, solutions, explainers) and linting requirements. Unlikely to conflict with generic file creation or other skills.	3 / 3
	Total	12 / 12 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: SnowingFox/ai-skills
Path: .cursor/skills/scaffold-exercises/SKILL.md
Commit: d6882ad

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