CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-design

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

Quality

79%

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

75%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 well-engineered, token-efficient workflow skill: concrete state commands, a clearly sequenced design-approval flow with meaningful validation checkpoints, and disciplined progressive disclosure to external references. The main gaps are an unspecified failure-recovery procedure for complete-design and one unverifiable reference (compat.md).

Suggestions

Specify concrete recovery actions for complete-design submission failure (e.g. which error causes map to retrying the command versus re-proposing versus escalating to the user) instead of the generic "按具体原因处理".

Verify that reference/compat.md actually exists in the skill bundle, or inline the two-line compat routing rule and drop the dangling reference.

Consolidate the repeated context-reuse rules (load-once conditions for task context, SDK methods, and layout) into a single stated rule to remove redundancy across the intro and SDK section.

DimensionReasoningScore

Conciseness

The body is densely operational with no padding and no explanation of concepts Claude already knows — every sentence carries a workflow rule. Minor repetition of caching/reuse rules across the intro and SDK section ("本会话已有且仍有效时直接复用", "不要因加载下一 Skill 再读一次", "同一阶段连续执行不重复获取") could be consolidated, fitting 'efficient; minor instances that could be trimmed' rather than the lean 5 anchor.

4 / 5

Actionability

Provides copy-paste-ready state commands with exact flags and placeholder sources ("comet state propose-design <change-name> --proposal \"<candidate-summary>\"", "comet state decide-design <change-name> --proposal-hash <proposalHash> --choice <approved|rejected>", with proposalHash sourced from data.wait.proposalHash). It falls short of 5 because the core design-formation and confirmation methodology is delegated to external SDK method references rather than specified in actionable detail here.

4 / 5

Workflow Clarity

Steps 1–4 form a clear propose → decide → complete sequence with explicit checkpoints (verify the handoff Markdown matches the candidate and current sources, stop until the reconcile result is clear, reuse the existing Wait on restore, handle stale proposal hashes by re-recording with the current proposal). The failure feedback loop is present but vague ("提交失败时保留原 Run 并按具体原因处理" gives no mapping of causes to actions), a minor gap versus the 5 anchor's explicit error-recovery loops.

4 / 5

Progressive Disclosure

A short orchestrator body with well-signaled, purpose-stated, one-level references into per-topic docs (sdk-methods.md Design chapter, decision-point.md, classic-layout.md, edit-review.md), with load-condition rules to avoid re-reading. It is not a 5 because no references/ bundle directory exists in the provided skill bundle to verify the referenced "reference/compat.md", and references are scattered across multiple sibling skills (../comet-classic/, ../comet/) without a consolidated listing.

4 / 5

Total

16

/

20

Passed

Description

75%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 concise, third-person description with an explicit use-when clause and highly distinct command/phase triggers that make conflict risk minimal. Its weaknesses are limited action specificity (only two high-level actions) and reliance on a single user-facing trigger term with no natural-language synonyms.

Suggestions

Enumerate the phase's key actions (e.g. 形成候选技术方案、propose-design 提案、decide-design 记录用户决定、写入 Design Doc) so the 'what' is comprehensive rather than two high-level actions.

Add natural-language trigger phrases a user might say beyond the slash command (e.g. 技术设计、设计方案、design proposal) to broaden keyword coverage.

DimensionReasoningScore

Specificity

"完成 Classic 技术设计并请用户确认" names the domain and exactly two concrete actions (complete the design, obtain user confirmation), matching the '1-2 concrete actions, not comprehensive' anchor. It is not a 4 because the description omits the proposal, decision, and design-doc actions the body actually performs; not a 2 because the actions go beyond minimal or generic.

3 / 5

Completeness

Both questions are answered explicitly and concretely: what ("完成 Classic 技术设计并请用户确认") and when ("在用户调用 /comet-design,或 Classic Runtime 进入 Design 时使用") — an explicit use-when clause with two concrete trigger conditions, matching the top anchor. Not a 4 because the 'when' is already fully explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

The only genuinely user-natural trigger is the literal slash command "/comet-design"; "Classic Runtime 进入 Design 时使用" describes internal runtime state, not a phrase a user would say. Common natural variations (e.g. 技术设计, 设计方案, design proposal) are missing, fitting 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

The description binds to a unique slash command (/comet-design) and a specific runtime phase (Classic Runtime entering Design), creating a clear niche with distinct triggers and minimal conflict risk even against sibling comet-family skills, which trigger on their own commands and phases.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 4 suspicious

Warning

Total

15

/

16

Passed

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.