CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-template

技能创建模板。复制此目录并修改 SKILL.md 即可创建新技能。请将所有 <占位符> 替换为实际内容。

48

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/_template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 body is a well-organized, lean template skeleton with clear section structure and no unnecessary padding, but it offers almost no actionable content because every section is an empty placeholder. Workflow and progressive-disclosure benefit from the clean structure, while actionability is the clear weak point.

Suggestions

Replace placeholder bodies with at least one concrete, copy-paste-ready example (real step text, a real parameter table, and a real input/output pair) so the template demonstrates executable guidance, not just shape.

Add an explicit validation/verification checkpoint to the 核心逻辑 workflow (e.g., a 'validate the filled-in SKILL.md' step) to raise workflow_clarity above 3.

Provide a short completed worked example alongside the blank template so users can see the intended result and the steps become actionable.

DimensionReasoningScore

Conciseness

The skeleton is lean with no over-explanation of concepts Claude already knows and no padded prose; placeholders are terse. It is not a 5 only because the placeholder tokens carry no real informational payload beyond structure.

4 / 5

Actionability

The body is almost entirely placeholders ('〈详细说明此步骤的逻辑〉', '〈示例输入〉', '〈示例输出〉') with no executable code or commands; it provides a structural skeleton but no specific steps a user can actually execute against a real task.

2 / 5

Workflow Clarity

A clear sequenced skeleton is present (任务目标 → 使用方式 → 核心逻辑 步骤1/2/3 → 注意事项 → 示例), but the steps are empty placeholders with no validation checkpoints, matching the anchor for steps listed but checkpoints missing.

3 / 5

Progressive Disclosure

No bundle files exist and the body is self-contained with well-organized, clearly headed sections and no nested references; it is not a 5 because the body is slightly over 50 lines and consists of placeholder skeleton rather than substantive overview content.

4 / 5

Total

13

/

20

Passed

Description

50%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 clearly communicates that this is a skill-creation template and what to do with it, but it omits any 'Use when' trigger guidance and relies on only a few natural keywords. As a result it sits at the midpoint across all dimensions.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when creating a new skill from scratch or scaffolding a skill directory') to raise completeness and trigger_term_quality.

Broaden trigger-term coverage with natural synonyms a user would actually say, such as 'skill template', 'scaffold a skill', 'new skill', '技能模板', '创建技能'.

Make the capability statement more specific about what the template provides (section scaffolding, parameter table, example blocks) to improve specificity and distinctiveness.

DimensionReasoningScore

Specificity

It names the domain ('技能创建模板') and concrete actions ('复制此目录', '修改 SKILL.md', '替换占位符'), but the actions are meta-instructions for using the template rather than descriptions of real skill capabilities, so coverage is not comprehensive.

3 / 5

Completeness

It has a clear 'what' (a skill-creation template) but no 'when'/'Use when' clause, which per the judging guidelines caps completeness at 3.

3 / 5

Trigger Term Quality

It includes relevant keywords like '技能创建模板' and '创建新技能' that a user might say, but it lacks common synonyms/variations and has no explicit trigger phrasing.

3 / 5

Distinctiveness Conflict Risk

The template niche is somewhat specific but generic enough that it could still overlap with other skill-authoring helpers; no distinct trigger phrases reduce conflict risk.

3 / 5

Total

12

/

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
anbeime/skill
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.