CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scaffold-exercises

创建包含章节、题目、答案和讲解的练习目录结构,并确保通过 linting。适用于用户想 scaffold exercises、创建 exercise stubs,或设置新的课程章节时。

Quality

88%

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

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.

An exemplary procedural skill body: concrete commands, a worked plan-to-stubs example, and a lint-validated workflow with an explicit fix-and-retry loop. The only weaknesses are minor — slight duplication between the required-files section and the lint-rules summary.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no concept explanations, no library comparisons, no tutorial padding — with executable commands throughout. The only redundancy is that readme requirements ('非空…没有 broken links') appear in both 必需文件 and Lint 规则摘要, a minor instance of duplication that could be trimmed; this keeps it at anchor 4 rather than 5.

4 / 5

Actionability

Fully executable guidance: 'pnpm ai-hero-cli internal lint', 'git mv' with a concrete example, 'mkdir -p' with brace expansion, a stub readme template, and a complete worked example that turns a sample plan into mkdir commands and per-file readme stub contents. Copy-paste ready and covering the common cases — anchor 5.

5 / 5

Workflow Clarity

The workflow is a clear five-step sequence (parse plan → mkdir → create stubs → run lint → fix errors) with an explicit validation checkpoint and a feedback loop ('Fix any errors - 迭代直到 lint 通过' — iterate until lint passes) for a batch directory-creation operation. Anchor 5's explicit validation plus error-recovery loop is satisfied; not 4 because no checkpoints are missing.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories (references/, scripts/, assets/) and nothing that clearly warrants splitting into separate files; sections are well-organized and easy to navigate. At ~100 lines it exceeds the under-50-line simple-skill threshold, so it sits at anchor 4 (good structure, content appropriately placed) rather than 5.

4 / 5

Total

18

/

20

Passed

Description

82%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 well-crafted description with an explicit 'use when' trigger clause and a distinct, well-bounded niche. Its main limitation is that it advertises only 1-2 of the skill's actual capabilities, underselling the move/rename and stub-creation workflows the body documents.

Suggestions

Mention one or two more concrete capabilities in the description (e.g. generating stub readmes, or renumbering/moving exercises with git mv) to lift specificity from 1-2 actions to several.

Add a natural trigger synonym or two (e.g. '练习目录' / 'exercise directories', or '新增课程章节') so more user phrasings match the skill.

DimensionReasoningScore

Specificity

The description names the domain concretely ('创建包含章节、题目、答案和讲解的练习目录结构' — create exercise directory structures with sections, problems, answers, and explainers) plus one more action ('确保通过 linting' — ensure lint passes). That is 1-2 concrete actions rather than the several specific actions anchor 4 requires, and it omits other capabilities the body covers (stub readme creation, moving/renaming exercises, git commit).

3 / 5

Completeness

Both halves are explicit: the 'what' ('创建…练习目录结构,并确保通过 linting') and a concrete 'when' clause ('适用于用户想 scaffold exercises、创建 exercise stubs,或设置新的课程章节时') listing three trigger scenarios. This matches anchor 5: both what and when clearly and explicitly answered with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say: 'scaffold exercises', '创建 exercise stubs' (create exercise stubs), '设置新的课程章节' (set up new course sections). Coverage is good but misses common variations and synonyms (e.g. '练习' (exercises), 'new exercise', 'curriculum'), falling just short of anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche — scaffolding course exercise directory structures validated by a project-specific linter — with trigger terms (scaffold exercises, exercise stubs, course sections) that are unlikely to fire for any other skill. Minimal conflict risk, matching anchor 5.

5 / 5

Total

17

/

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

vinvcn/mattpocock-skills-zh-CN

Path

skills/misc/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.