CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-skills

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

56

Quality

67%

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%

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

The content is a thorough, highly actionable meta-skill with strong workflow sequencing, concrete examples, and validation feedback loops. Its main weaknesses are length/redundancy that hurt token efficiency and progressive disclosure: a monolithic body plus references to bundle files that are not actually present.

Suggestions

De-duplicate the rationalization-excuses material (it appears both as the "跳过测试的常见合理化借口" table and the "构建合理化借口表" example) and consolidate the repeated "铁律" statements to tighten conciseness.

Either provide the referenced bundle files (anthropic-best-practices.md, persuasion-principles.md, testing-skills-with-subagents.md, graphviz-conventions.dot, render-graphs.js) under references/scripts/assets, or remove the dangling references so navigation is not broken.

Move large reference-like sections (e.g., the full CSO keyword/naming guidance) into a separate reference file and keep SKILL.md as a lean overview to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dense and mostly efficient, but ~600 lines long with redundancy — e.g., the rationalization-excuses table appears twice (the "跳过测试的常见合理化借口" table and the "构建合理化借口表" example) and the "铁律" is stated in its own section then restated in the summary — matching 'mostly efficient but includes some unnecessary explanation or could be tightened'. Not level 1 because it frames TDD for a novel application rather than restating known concepts, and not level 3 due to the repetition and length.

2 / 3

Actionability

It provides concrete, copy-paste-ready guidance: the TDD-mapping table, before/after YAML description examples, the "技能创建清单" with explicit checkboxes, and runnable commands like "./render-graphs.js ../some-skill --combine" and "wc -w skills/path/SKILL.md". This matches 'fully executable code/commands; specific examples; copy-paste ready'.

3 / 3

Workflow Clarity

The red-green-refactor process is clearly sequenced with explicit validation checkpoints — "用技能运行场景 - 验证智能体现在遵守" and "重新测试直到无懈可击" form a validate→fix→retry feedback loop, and the checklist breaks it into red→green→refactor phases. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists'.

3 / 3

Progressive Disclosure

References are one-level-deep and clearly signaled (e.g., "参见 persuasion-principles.md 了解研究基础", "参见 @testing-skills-with-subagents.md"), but the body is a ~600-line monolithic document with content (CSO details, rationalization tables) that could be split, and the referenced bundle files (anthropic-best-practices.md, graphviz-conventions.dot, render-graphs.js, testing-skills-with-subagents.md, persuasion-principles.md) do not exist in any references/scripts/assets directory, breaking navigation. Not level 1 because references are not nested 2+ levels and sections are headed, and not level 3 because of the monolithic length and broken external links.

2 / 3

Total

10

/

12

Passed

Description

57%

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 concise, third-person, trigger-focused clause that clearly signals when to use the skill, consistent with the skill's own CSO philosophy. Its main weakness is that the named actions are generic and the 'what' is only implied, leaving it somewhat thin on specificity and trigger-term richness.

Suggestions

Add concrete technical actions (e.g., 'write stress-test scenarios with subagents, capture baseline failures, draft SKILL.md') so specificity reaches the multiple-concrete-actions anchor.

Broaden trigger-term coverage with natural synonyms users might say ('authoring skills', 'testing a skill before deploy', 'skill validation', 'SKILL.md').

Optionally pair the trigger clause with a brief 'what' phrase so completeness answers both what and when distinctly.

DimensionReasoningScore

Specificity

Names the domain and three actions — "创建新技能、编辑现有技能…验证技能是否有效" (create, edit, verify) — but these are generic verbs rather than concrete technical mechanisms, matching the anchor 'names domain and some actions, but not comprehensive'. It is not level 3 because no multiple specific concrete actions (like 'extract text, fill forms, merge') are listed, and not level 1 because real actions are named.

2 / 3

Completeness

It has an explicit "当…时使用" (Use when) trigger clause answering 'when', but 'what' is only implied through those trigger contexts, so what and when collapse rather than being clearly distinct. Not level 3 because it lacks a distinct statement of what the skill does alongside the trigger, and not level 1 because an explicit trigger clause is present.

2 / 3

Trigger Term Quality

Contains natural trigger terms a user would say — "创建新技能", "编辑现有技能", "验证", "部署前" — but the vocabulary is thin with no synonyms or variations, matching 'some relevant keywords but missing common variations'. Not level 3 because coverage is not rich, and not level 1 because the terms are natural rather than jargon.

2 / 3

Distinctiveness Conflict Risk

It is scoped to a clear niche — skill authoring/deployment ("技能…部署前验证") — with distinct triggers unlikely to fire for unrelated skills. Not level 2 because the repeated "技能" framing makes it more distinct than 'works with document files', and level 1 would require generic phrasing like 'helps with code and documents'.

3 / 3

Total

9

/

12

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 (660 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.