CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verification-before-completion

在宣称工作完成、已修复或测试通过之前使用,在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功;始终用证据支撑断言

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

A highly actionable, well-structured behavioral skill: the gated 5-step procedure, claim→evidence table, and ✅/❌ patterns make the rule directly executable, and validation with feedback loops is intrinsic to the design. The main cost is redundancy — the 红线 and 防止合理化 sections substantially restate content from 常见失败模式, adding tokens without adding guidance.

Suggestions

Merge 红线 and 防止合理化 into a single table (信号 | 借口 | 应对) — they currently restate the same failure modes (agent reports, linter≠compiler, partial checks) in two formats, cutting ~20 lines.

Drop duplicated rows from 防止合理化 that already appear verbatim in 常见失败模式 (e.g. "代理报告成功" vs "代理说成功了") and keep one canonical table of rationalizations.

Tighten 关键模式 examples that restate table rows (构建/Linter and 代理委派 patterns repeat 常见失败模式 content); keeping the table plus one composite worked example would preserve the teaching value at lower token cost.

DimensionReasoningScore

Conciseness

The body is mostly lean but repeats the same discipline across overlapping sections: the agent-trust rule appears in 常见失败模式, 红线, and 防止合理化; "Linter ≠ 编译器" appears twice (常见失败模式 table and 防止合理化 table); and 红线 largely restates 防止合理化. This is deliberate emphasis, but from a token-budget view the red-lines and anti-rationalization sections could be merged, fitting the "could be tightened" anchor 3 rather than 4.

3 / 5

Actionability

For an instruction-only skill the guidance is maximally concrete: a 5-step gated procedure (确定 → 运行 → 阅读 → 验证 → 结论) with explicit success criteria (0 failures, exit 0, 红-绿 cycle), a claim→required-evidence mapping table, and ✅/❌ example patterns. Every instruction is directly followable, matching anchor 5.

5 / 5

Workflow Clarity

The 门控函数 gives a clearly sequenced 5-step process with an explicit decision branch and feedback loop (如果输出不支持结论 → 用证据说明实际状态), and validation checkpoints are the core of the skill rather than an afterthought, matching the anchor-5 pattern.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed for a behavioral rule. The single SKILL.md is well organized with clear section headers, one-level-flat content, no buried or nested references, and each section (gate function, failure modes, patterns, scope) appropriately placed.

5 / 5

Total

18

/

20

Passed

Description

83%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.

A strong description with an explicit use-when clause, concrete triggers, and a clear behavioral contract (evidence before claims). Its only weaknesses are slightly limited synonym coverage in triggers and minor co-trigger risk with adjacent commit/PR skills.

Suggestions

Broaden trigger synonyms to catch more phrasings users naturally employ, e.g. "标记任务完成" (marking tasks done), "声称成功", "搞定/完成" (declaring done), or English equivalents like "tests are green".

Sharpen the distinction from code-review/commit-message skills by leading with the verification gate framing (e.g. "这是完成前的证据验证门控,而非代码审查") so the commit/PR trigger terms don't co-select those skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "必须运行验证命令并确认输出后才能声称成功" and "始终用证据支撑断言" — tied to specific milestones (tests pass, fixed, commit, PR). It falls short of 5 because it doesn't comprehensively enumerate the skill's actions, but exceeds 3 since it names more than 1-2 concrete behaviors.

4 / 5

Completeness

It explicitly answers both questions: what ("必须运行验证命令并确认输出后才能声称成功;始终用证据支撑断言") and when ("在宣称工作完成、已修复或测试通过之前使用,在提交或创建 PR 之前") with concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural trigger phrases users/agents would actually say are present: "宣称工作完成", "已修复", "测试通过", "提交", "创建 PR", "验证命令". Good coverage, but a few natural variations (e.g. "声称成功" contexts like "标记任务完成", "搞定") are missing, keeping it below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The pre-completion-verification niche is clear and distinct from data-format or tool skills. Minor overlap risk exists with commit/PR-related skills since "提交或创建 PR" could co-trigger those, but the framing as a pre-claim verification gate keeps it mostly distinct.

4 / 5

Total

17

/

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/verification-before-completion/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.