CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-plans

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

Quality

68%

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 body is a dense, highly actionable planning guide: exact paths, copy-paste templates with runnable commands, a self-check validation checklist with an inline-fix feedback loop, and scripted execution handoff. Only minor tightening of rationale prose and optional template extraction keep it off the top anchor.

DimensionReasoningScore

Conciseness

The body is dense, project-specific instruction with no padding ("DRY。YAGNI。TDD。频繁 commit。") and no basic-concept tutorials, but a few passages explain reasoning Claude largely already knows ("你对能一次放入上下文的代码推理得最好,文件越专注你的编辑越可靠", the small-files rationale in 文件结构, and the long bracketed guidance in 审查重点). Minor trimmable over-explanation = 4, not 5.

4 / 5

Actionability

Fully concrete and copy-paste ready: exact save path "docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md", complete plan-header and task templates, runnable verification commands ("pytest tests/path/test.py::test_name -v", "git commit -m \"feat: add specific feature\""), a 5-item self-check, and exact handoff dialogue scripts. The one deliberately flexible step ("用一行说明做法") is explicitly justified by the skill's decision-vs-copy rule.

5 / 5

Workflow Clarity

The process is explicitly sequenced — announce ("我正在使用 writing-plans 技能创建实现计划") → scope check → file structure → task decomposition → write plan → 自检 → handoff — with a 5-item validation checklist (spec coverage, step scan, type consistency, review focus, proportion) and an explicit fix-then-continue feedback loop ("如果发现问题,直接内联修复").

5 / 5

Progressive Disclosure

A single-file skill with no bundle files to reference; sections are clearly organized and cross-skill dependencies are well signaled ("必需子技能:使用 subagent-driven-development"). Everything appropriately lives in SKILL.md at this size, though the ~40 lines of plan/task templates could move to reference files as the skill grows — good structure with minor organization headroom = 4.

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, reasonably specific trigger scenario but omits the 'what' entirely — it never states that the skill creates implementation plans breaking specs into sequenced TDD tasks. It reads as half a description: a strong 'when' with an absent 'what', which also leaves it hard to distinguish from neighboring workflow skills.

Suggestions

Lead with the 'what', e.g. "编写实现计划:把规格拆解成逐个可测试、可 commit 的任务清单" — state the concrete deliverable before the 'Use when' clause (fixes completeness).

Add the missing core trigger words "计划"/"实现计划"/"plan" and natural synonyms like "拆解任务"/"实现方案" so users asking for planning help match the skill (fixes trigger_term_quality).

Mention the concrete output artifact — a plan document with tasks, files, tests, and commit steps saved to docs/superpowers/plans/ — to sharpen specificity and distinguish it from adjacent skills like brainstorming and executing-plans.

DimensionReasoningScore

Specificity

The description names the domain ("规格说明或需求用于多步骤任务时使用,在动手写代码之前") but states no concrete action — it never says the skill writes implementation plans or what it produces. This matches 'names the domain but actions are minimal or generic'; it is above 1 because the domain is concrete, but below 3 because zero actions are listed.

2 / 5

Completeness

Only the 'when' half is present ("当你有规格说明或需求用于多步骤任务时使用,在动手写代码之前"); the 'what' is entirely absent — the description never states that the skill creates implementation plans decomposing specs into testable, committable tasks. This exactly matches anchor 2 ('only when is present without what', e.g. 'Use when working with documents') and cannot be 3, whose anchor requires a clear 'what'.

2 / 5

Trigger Term Quality

Natural keywords are present ("规格说明", "需求", "多步骤任务", "写代码"), but common variations and synonyms are missing — most notably the skill's own core term "计划"/"plan"/"规划", plus phrases like "实现方案" or "拆解任务". Good enough to be above 2's generic level, but not 4's 'good coverage with a few missing'.

3 / 5

Distinctiveness Conflict Risk

The trigger scenario (holding a spec/requirements before implementation) is somewhat specific, but because the deliverable ('plan') is never named, the description could overlap with adjacent development-workflow skills (brainstorming, spec drafting, executing-plans). Somewhat specific but residual overlap risk = 3.

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

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

Path

skills/writing-plans/SKILL.md

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.