CtrlK
BlogDocsLog inGet started
Tessl Logo

teach

在这个工作区中教用户一个新技能或概念。

47

Quality

51%

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 ./skills/productivity/teach/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-organized, instruction-only skill with genuinely actionable guidance on lesson design, asset reuse, and workspace state, held back by a missing operational backbone. The three referenced format files do not exist in the bundle, and the teaching process is presented conceptually rather than as a sequenced workflow, so a first-time invocation requires synthesis and will hit broken references.

Suggestions

Ship the referenced format files (MISSION-FORMAT.md, RESOURCES-FORMAT.md, LEARNING-RECORD-FORMAT.md) in the bundle, or inline their formats so the '使用 ... 中的格式' instructions are followable.

Add an explicit session workflow (e.g., 1. Read MISSION.md and learning-records → 2. Confirm mission if empty → 3. Gather resources → 4. Build lesson from ./assets/ → 5. Record learning) with checkpoints.

Trim the Fluency/Storage-strength definitions and the retrieval-practice/spacing/interleaving glosses to a single line each, trusting Claude's knowledge of these concepts.

DimensionReasoningScore

Conciseness

The body is dense and directive ("复用是默认,而不是例外", "每个答案都应有完全相同的词数"), with only minor over-explanation of concepts Claude already knows, such as defining "Fluency strength"/"Storage strength" and glossing retrieval practice, spacing, and interleaving. It is not 5 because the Philosophy section's learning-science definitions could be tightened to one line each.

4 / 5

Actionability

Concrete, specific guidance throughout: file naming ("0001-<dash-case-name>.md", 递增), asset reuse rules ("在编写一个 lesson 之前,先读取 `./assets/`"), quiz design constraints, and mission-change confirmation. It is not 5 because the referenced format files (MISSION-FORMAT.md, RESOURCES-FORMAT.md, LEARNING-RECORD-FORMAT.md) are absent from the bundle and no lesson example or template is provided, leaving gaps in executable detail.

4 / 5

Workflow Clarity

Sequencing cues are scattered but present ("你的第一项工作应是询问用户为什么想学这个", "在 RESOURCES.md 还没有充分填充前,你的重点应是...") and the mission/ZPD sections imply an order, yet the body is organized by concept rather than as an ordered workflow with checkpoints. It is not 4 because there is no explicit end-to-end sequence for a session (read mission → check learning records → find resources → build lesson) and validation/checkpoints remain implicit; it is above 2 because the rough sequence is recoverable.

3 / 5

Progressive Disclosure

The body is well-sectioned and references are clearly signaled one level deep, but all three referenced format files (MISSION-FORMAT.md, RESOURCES-FORMAT.md, LEARNING-RECORD-FORMAT.md) are missing from the skill bundle, so instructions like "使用 MISSION-FORMAT.md 中的格式" cannot be followed. It is not 4 because dangling references are a real navigation failure; it is not 2 because the in-body structure itself is good and nothing that belongs in separate files is inlined.

3 / 5

Total

14

/

20

Passed

Description

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

The description is short and clear but underspecified: it states a single generic capability and provides no trigger guidance or concrete feature list. The workspace framing gives it mild distinctiveness, yet it reads closer to "Helps with documents"-level generality than to a well-specified skill description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to learn, study, or be taught a topic over multiple sessions.'

Enumerate 2-3 concrete capabilities (creates interactive HTML lessons, tracks learning records, builds reference sheets) to raise specificity.

Mention the multi-session/stateful workspace nature to differentiate it from one-off explanation skills.

DimensionReasoningScore

Specificity

The description names the teaching domain with a single generic action ("教用户一个新技能或概念") but lists no concrete capabilities such as lessons, quizzes, or learning records. It matches anchor 2 (domain named, actions minimal/generic) rather than 3, which requires 1-2 concrete actions.

2 / 5

Completeness

It has a clear "what" (teach a new skill or concept in this workspace) but no "when" or 'Use when...' equivalent, which caps completeness at 3 per the judging guidelines. It is not 4 because no trigger guidance exists even implicitly.

3 / 5

Trigger Term Quality

Only the generic terms "技能" and "概念" appear; natural trigger phrases a user would actually say ("learn", "teach me", "study") are absent. This matches anchor 2 (one or two generic keywords, missing natural phrases), not 1, since the domain terms are at least relevant.

2 / 5

Distinctiveness Conflict Risk

"在这个工作区中" hints at the teaching-workspace niche, but "teach a new skill or concept" broadly overlaps with general explanation and tutoring skills. Somewhat specific but overlap risk remains (anchor 3); not 4 because the description does not convey the stateful multi-session workspace mechanics that make this skill distinct.

3 / 5

Total

10

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

description_field

'description' is very short (19 chars), consider making it more detailed

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

13

/

16

Passed

Repository
vinvcn/mattpocock-skills-zh-CN
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.