CtrlK
BlogDocsLog inGet started
Tessl Logo

comet-verify

仅在用户明确调用 /comet-verify,或由 Comet 根 Skill/runtime 路由到 verify 阶段时使用;验证 Comet change、记录证据并处理修复循环。

68

Quality

81%

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

77%

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-sequenced verify-phase workflow with strong validation checkpoints and feedback loops. Its weaknesses are repetition that inflates length and a monolithic structure that keeps reference-style detail inline rather than splitting it out.

Suggestions

De-duplicate the repeated `node "$COMET_STATE" transition <change-name> verify-fail` blocks and the '立即执行' Skill-loading directives by defining them once and referencing the shared step, to tighten conciseness.

Move the elaborate dirty-worktree special-casing and scale-assessment threshold rules into a referenced reference doc (e.g. the existing dirty-worktree.md) and keep SKILL.md as a lean overview, improving progressive disclosure.

DimensionReasoningScore

Conciseness

The body is mostly efficient, command-dense guidance that does not lecture Claude on known concepts, but it repeats the same `transition ... verify-fail` block and '立即执行' directives across Steps 1, 1b, 2a and 2b and could be tightened — placing it at 'mostly efficient but could be tightened' rather than the lean level-3 anchor.

2 / 3

Actionability

It provides fully executable, copy-paste-ready commands (`node "$COMET_STATE" check/scale/transition/set ...`, `git diff --stat "$BASE_REF"...HEAD`) with concrete parameters and shell snippets, matching the 'fully executable code/commands; copy-paste ready' anchor; it is well above the pseudocode/incomplete level 2.

3 / 3

Workflow Clarity

Steps are clearly sequenced (0a→0b→1→1b→2a/2b→3→4) with explicit validation checkpoints (entry check, pass/fail decision block, exit conditions, phase guard) and a real feedback loop with a 3-retry cap, satisfying the 'clear sequence with explicit validation steps; feedback loops for error recovery' anchor.

3 / 3

Progressive Disclosure

External references are clearly signaled and one level deep (`comet/reference/scripts.md`, `decision-point.md`, `dirty-worktree.md`, etc.), but the SKILL.md itself is a long, fairly monolithic procedure with substantial inline detail (scale-assessment rules, dirty-worktree special handling) that could live in referenced files — matching 'some structure but content that should be separate is inline' rather than the cleanly split level-3 anchor. No bundle files exist under references/scripts/assets to verify the referenced paths against.

2 / 3

Total

10

/

12

Passed

Description

85%

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 concise, well-structured description that clearly states both capability and an explicit state-based trigger. Its main weakness is trigger-term naturalness — the keywords are workflow-internal jargon rather than varied user phrasings.

Suggestions

Broaden trigger terms toward natural user phrasings (e.g. mention 'review/verify the change', 'wrap up the branch', 'handle failed checks') alongside the workflow-stage terms so users are more likely to match it in their own words.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — '验证实现' (verify implementation), '处理验证失败决策' (handle verification-failure decisions), '完成分支收尾' (complete branch wrap-up) — matching the 'lists multiple specific concrete actions' anchor; it is not the level below which only names a domain and a single action.

3 / 3

Completeness

It explicitly answers both 'what' (verify implementation, handle failure decisions, finish branch) and 'when' via the explicit 'Use when Comet change 已完成 build 阶段...' trigger clause, satisfying the 'clearly answers both what AND when with explicit triggers' anchor; the 'Use when' clause is present so it is not capped at 2.

3 / 3

Trigger Term Quality

It includes relevant trigger keywords tied to workflow state ('已完成 build 阶段', '验证', '分支收尾') but these are workflow-internal jargon rather than the natural varied phrasings a user would commonly say, so it sits at 'some relevant keywords but missing common variations' rather than the full coverage of level 3.

2 / 3

Distinctiveness Conflict Risk

The trigger is tightly scoped to 'Comet change' in a specific lifecycle state ('已完成 build 阶段'), giving it a clear niche unlikely to fire for unrelated skills; it is distinguishable rather than the 'somewhat specific but could overlap' level 2.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
rpamis/comet
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.