CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-design

完成 Classic 技术设计并请用户确认。在用户调用 /comet-design,或 Classic Runtime 进入 Design 时使用。

59

Quality

74%

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 ./assets/skills-zh/comet-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 strongly sequenced, guard-validated workflow with copy-paste CLI commands and explicit user-confirmation checkpoints — workflow clarity and actionability are high. Its weaknesses are redundant restatements of entry/recovery and compression rules, and inlining of handoff-format details that belong in a reference file.

Suggestions

State the entry-check/state-recovery and context-compression rules once and reference comet-classic/reference/context-recovery.md from each step, instead of repeating them in Step 0, Step 1e, Step 2, and the closing sections.

Move the handoff pack format details (design-context.json/md and beta spec-context structure, truncation markers, hash fields) into a reference file, keeping only the command and a one-line purpose inline in SKILL.md.

Include a short sample of the JSON output fields the workflow depends on (data.designReadiness, data.issues, agent.continuation) so validation and recovery steps can be executed without guesswork.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no explanations of concepts Claude already knows, but the entry-check/state-recovery rules and context-compression rules are each restated three to four times across Step 0, Step 1e, Step 2, and the closing sections. This repetition is more than minor over-explanation, matching the 'mostly efficient but could be tightened' anchor rather than score 4's 'minor instances'.

3 / 5

Actionability

Nearly every step is backed by exact, executable commands ('comet handoff <change-name> design --write', 'comet state complete-design <name> --design-doc "..." --json', 'comet guard <change-name> design --apply'), plus exact file paths, a frontmatter template, and a full brainstorm-summary.md template. It falls short of score 5 because the JSON result fields it relies on (data.designReadiness, data.issues, agent.continuation) are referenced without any sample output or field format.

4 / 5

Workflow Clarity

Steps are clearly sequenced (0 entry check → 1a–1e design loop → 2 create Design Doc → 3 update state → 3a optional compression → exit conditions → auto-transition) with explicit validation checkpoints: the entry verification, the mandatory user confirmation gate in Step 1c, guard-enforced exit conditions, and a failure feedback loop ('失败时处理 data.issues,保留成果并重试同一 complete-design').

5 / 5

Progressive Disclosure

References to comet-classic/reference/*.md files are clearly named, but the skill's own bundle contains no reference files at all, and reference-grade detail — the default and beta handoff pack formats, truncation markers, hash fields, and compression-recovery rules — is inlined directly in SKILL.md. This matches the 'content that should be separate is inline' anchor rather than score 4's 'most content appropriately placed'.

3 / 5

Total

15

/

20

Passed

Description

66%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 cleanly and explicitly covers both what the skill does and when to use it, with a distinctive slash-command trigger that minimizes conflict risk. Its main weaknesses are thin specificity about the phase's actual outputs and a narrow set of trigger terms with no natural-language variations.

Suggestions

Mention the concrete artifacts the design phase produces (Design Doc, OpenSpec delta spec patches, handoff pack) so the 'what' goes beyond 'complete the technical design and confirm with the user'.

Add natural-language trigger variations beyond the /comet-design slash command, such as '技术设计', '深度设计', or 'design 阶段', so the skill also matches users who describe the task without the exact command.

DimensionReasoningScore

Specificity

The description names the domain ('Classic 技术设计') and two concrete actions ('完成...技术设计并请用户确认'), but does not mention the phase's core artifacts such as the Design Doc, delta spec patches, or handoff pack. It matches the anchor for naming a domain with 1-2 concrete actions that are not comprehensive, rather than the minimal/generic actions of score 2 or the several specific actions of score 4.

3 / 5

Completeness

Both parts are explicitly answered: 'what' ('完成 Classic 技术设计并请用户确认') and 'when' ('在用户调用 /comet-design,或 Classic Runtime 进入 Design 时使用'), with the 'when' being concrete and specific. It falls short of score 5 because the 'what' is terse and omits what the phase actually produces (brainstorming output, Design Doc, spec patches, guard checks).

4 / 5

Trigger Term Quality

Explicit triggers are present ('用户调用 /comet-design', 'Classic Runtime 进入 Design'), and a user of this pipeline would naturally say them. However, coverage stops there — no natural variations or synonyms such as '技术设计', '深度设计', or 'design 阶段' — matching the 'some relevant keywords but missing common variations' anchor rather than the good coverage of score 4.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — phase 2 of the comet-classic pipeline — with a unique trigger ('/comet-design') and a runtime-phase condition, so generic design requests will not match it and it will not fire in place of other skills. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

15

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

rpamis/comet

Path

assets/skills-zh/comet-design/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.