CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-plans

当你有规格说明或需求用于多步骤任务时使用,在动手写代码之前

54

Quality

62%

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-plans/SKILL.md
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.

The content is a tight, highly actionable planning guide with concrete templates and an explicit self-check feedback loop. Its main limitation is the missing "what" lives only in the body while the description stays silent, and the long templates could be split into reference files.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its tokens with skill-specific guidance (file-structure principles, granularity rules, templates) rather than generic knowledge; only minor framing in 概述 could be trimmed.

4 / 5

Actionability

Provides copy-paste-ready templates: a plan-document header, a full task structure with exact file paths, failing-test code, pytest commands with expected output, and git commit commands, plus concrete forbidden-placeholder patterns.

5 / 5

Workflow Clarity

A clear sequenced process runs from 范围检查 through 文件结构, 任务粒度, templates, to an explicit 自检 checklist (spec coverage, placeholder scan, type consistency) with a fix-and-continue feedback loop.

5 / 5

Progressive Disclosure

Well-organized into clearly labeled sections with no nested references and no bundle files; the long inline templates (task structure, forbidden placeholders) could arguably live in separate reference files but are appropriately placed for a single-purpose skill.

4 / 5

Total

18

/

20

Passed

Description

36%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 gives a clear trigger (when you have specs for a multi-step task, before coding) but omits what the skill actually produces, leaving it incomplete and lightly specified. Adding an explicit action clause would lift both completeness and specificity.

Suggestions

Lead with what the skill does, e.g. "编写多步骤任务的实现计划,分解为可独立测试的小步骤任务" before the trigger.

Expand trigger terms with synonyms users actually say ("规格", "需求文档", "technical spec", "实现方案", "拆任务").

Distinguish from sibling skills, e.g. "用于将已确定的规格转化为可执行计划,而非头脑风暴或执行阶段".

DimensionReasoningScore

Specificity

The description names the domain ("规格说明或需求用于多步骤任务") but states no concrete actions — it never says what the skill does (e.g. write/decompose a plan), only when to invoke it.

2 / 5

Completeness

Only the "when" is present and explicit; the "what" (the skill produces an implementation plan) is entirely missing, matching the anchor where only "when" is present without "what".

2 / 5

Trigger Term Quality

Natural trigger phrases like "规格说明或需求" (specs/requirements), "多步骤任务" (multi-step tasks), and "动手写代码之前" (before writing code) are present, but coverage lacks common synonyms or variations.

3 / 5

Distinctiveness Conflict Risk

The planning trigger is somewhat specific but could overlap with sibling skills like brainstorming or executing-plans, which share the same spec/task vocabulary.

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.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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

13

/

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.