CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-skills

当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用

64

Quality

78%

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

Quality

Content

77%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 highly actionable, well-sequenced TDD-for-skills methodology with concrete templates, commands, and validation checklists. Its weaknesses are length/repetition that hurts token efficiency and dangling references (missing bundle files plus @-syntax) that undermine progressive disclosure.

Suggestions

De-duplicate the description guidance that appears in both the "SKILL.md 结构" and "技能发现优化" sections, and consolidate the TDD discipline statements across "铁律", "让技能经受住合理化的考验", and the checklist to tighten the body toward the lean end of the conciseness scale.

Resolve the progressive-disclosure gap: either ship the referenced bundle files (anthropic-best-practices.md, graphviz-conventions.dot, testing-skills-with-subagents.md, persuasion-principles.md, render-graphs.js) or inline the essential parts, and replace "@" force-load references with plain skill-name cross-references as the skill's own guidance recommends.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its place, but at ~680 lines it repeats material — description guidance appears in both the "SKILL.md 结构" and "技能发现优化" sections, and TDD discipline is restated across "铁律", "让技能经受住合理化的考验", and the checklist — fitting the "mostly efficient but could be tightened" anchor rather than the lean 4 or 5.

3 / 5

Actionability

Provides copy-paste-ready YAML good/bad description examples, an explicit SKILL.md template, concrete commands ("wc -w", "./render-graphs.js"), a TodoWrite-driven checklist, and rationalization tables — fully actionable guidance whose specific examples cover the common cases, matching the top anchor for an instruction skill.

5 / 5

Workflow Clarity

Sequences the red-green-refactor loop with explicit validation checkpoints ("观察它们失败", "验证智能体现在遵守", "重新测试直到无懈可击"), feedback loops, and phased checklists for a complex process, matching the anchor for clear sequence with explicit validation and checklists.

5 / 5

Progressive Disclosure

Internal section structure is good and references are conceptually one level deep, but the referenced files (anthropic-best-practices.md, graphviz-conventions.dot, testing-skills-with-subagents.md, persuasion-principles.md, render-graphs.js) are absent from the bundle and several use the "@" force-load syntax the skill itself warns against, so references are not clearly signaled or verifiable — fitting the "some structure, references not clearly signaled" anchor rather than 4.

3 / 5

Total

16

/

20

Passed

Description

78%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 a well-formed third-person trigger that names three concrete skill-authoring actions with a clear, distinct niche and low conflict risk. Its main limitation is that what and when are merged into a single clause and it lacks synonym coverage, keeping completeness and trigger-term quality at 4 rather than 5.

DimensionReasoningScore

Specificity

Names three concrete actions — "创建新技能" (create new skills), "编辑现有技能" (edit existing skills), "验证技能是否有效" (verify skills are valid) — matching the anchor that lists several specific actions with minor coverage gaps; not a 5 because "验证...是否有效" is somewhat abstract compared to fully concrete operations.

4 / 5

Completeness

Explicit "当...时使用" (Use when) trigger with three concrete scenarios satisfies the when, and the action verbs convey the what; it is not a 5 because what and when are merged into one clause rather than a clearly separate "does X. Use when Y." statement.

4 / 5

Trigger Term Quality

Includes natural phrases a user would say ("创建新技能", "编辑现有技能", "部署前验证") giving good keyword coverage; stays at 4 rather than 5 because it lacks synonyms/variations and no file extensions apply, so coverage is not comprehensive.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche — authoring/editing/validating skill artifacts — with distinct triggers and minimal overlap risk, matching the "clear niche with distinct triggers" anchor; it would only fire when working on skills themselves.

5 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (680 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

12

/

16

Passed

Repository
jnMetaCode/superpowers-zh
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.