CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-classic

Comet Classic 工作流入口。当用户明确调用 /comet-classic、要求启动或恢复 Classic,或 resume-probe 返回 auto_resume、确认唯一可恢复的未归档 Classic change 时使用。

63

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-classic/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 orchestration hub: lean, highly actionable routing rules with copy-paste CLI commands, an explicit decision-point checklist, and strong validation/error-recovery loops across the five phases. The weak point is progressive disclosure — the body correctly defers detail to reference files, but those files are absent from the provided bundle and the reference paths use two inconsistent conventions.

Suggestions

Ship the referenced files with the skill bundle and verify all ~11 paths resolve (classic-layout.md, context-recovery.md, intent-frame.md, workspace.md, scripts.md, auto-transition.md, decision-point.md, dirty-worktree.md, debug-gate.md, comet-yaml-fields.md, file-structure.md were all absent from the provided bundle).

Standardize on one reference path convention (the `comet-classic/reference/...` inline form vs. `reference/scripts.md#anchor` markdown links are mixed), and consider a short table of reference files with their trigger conditions near the top so navigation is scannable in one place.

DimensionReasoningScore

Conciseness

The body is dense and operational throughout: it never explains concepts Claude already knows and almost every sentence carries a routing rule, a condition, or a command. A few long multi-clause sentences (e.g., the workspace/isolation paragraph) could be tightened, matching anchor 4 (efficient; minor instances that could be trimmed) rather than 5 (every token earns its place).

4 / 5

Actionability

Concrete, executable commands are given with full flags — `comet resume-probe . --stdin --json`, `comet classic workspace resolve <change-name> --json`, `comet state select`, `comet state next <name> --json`, `comet state transition <name> preset-escalate` — plus a bash block and explicit conditional rules ("只有 auto_resume 自动进入"). Minor gaps keep it at anchor 4: `comet task` and `comet knowledge remember` are invoked without syntax (deferred to reference/scripts.md), and several commands use placeholders the reader must substitute.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (numbered sections: determine workspace → load phase → continue work) with a phase routing table, an explicit checklist of blocking decision points ("以下确认不能…跳过"), validation gates (Guard checks, Verify's single final integration review, "只有实际运行过测试或构建,才能声称完成相应检查"), and error-recovery feedback loops (context-recovery, debug-gate's investigate-then-fix, state-update rejection handling). This matches anchor 5 (clear sequence, explicit validation, feedback loops, checklists); the destructive/batch cap does not apply since verification and authorization checks are explicitly required before archive/commit/push.

5 / 5

Progressive Disclosure

The in-body discipline is strong — each of ~11 reference files is read only under an explicit trigger with a named section (e.g., "读取 context-recovery.md 的 'Ambient Resume'", "需要状态字段含义时读 comet-yaml-fields.md"), one level deep. However, scored against the actual bundle: no references/, scripts/, or assets/ directories are present, so none of the referenced files can be verified to exist, and two inconsistent path conventions are used (`comet-classic/reference/...` inline code vs. `[任务上下文与产物语言](reference/scripts.md#…)` markdown links). This lands at anchor 3 (structure present, but organization/navigation cannot be confirmed) rather than 4-5.

3 / 5

Total

16

/

20

Passed

Description

73%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 and concrete trigger clause that clearly delimits when the skill activates and minimizes conflict with sibling skills. Its main weakness is the underspecified "what" — "workflow entry point" names the role but not the capabilities, capping specificity and completeness below the top anchors.

Suggestions

Add 1-2 concrete capability statements to the description (e.g., that it orchestrates the Open → Design → Build → Verify → Archive five-phase workflow and routes to /comet-open, /comet-build, /comet-verify, /comet-archive) so the "what" is more than "工作流入口".

Broaden trigger coverage with natural synonyms users might say, such as "继续/恢复上次的 Classic 工作" or "Classic change/流程", to strengthen trigger_term_quality.

DimensionReasoningScore

Specificity

The description names the domain ("Comet Classic 工作流入口") and 1-2 concrete actions ("要求启动或恢复 Classic", "确认唯一可恢复的未归档 Classic change"), but never states what the skill actually does once entered (e.g., orchestrating the Open/Design/Build/Verify/Archive phases or routing to sibling skills). This matches anchor 3 (names domain and 1-2 concrete actions, not comprehensive) rather than 4, which requires several specific listed actions.

3 / 5

Completeness

Both parts are present: an explicit "what" ("Comet Classic 工作流入口") and a highly explicit "when" ("当用户明确调用 /comet-classic、要求启动或恢复 Classic,或 resume-probe 返回 auto_resume…时使用"). It is not a 5 because the "what" is thin — "workflow entry point" alone does not tell the reader what the skill does — matching anchor 4 (both present, one could be more specific) rather than 3, where the when would be missing or only weakly implied.

4 / 5

Trigger Term Quality

Natural triggers are present and ecosystem-appropriate: "/comet-classic", "启动或恢复 Classic", "resume-probe 返回 auto_resume", "未归档的 Classic change". A few natural variations users might say (e.g., "继续 Classic", "Classic 流程/变更") are missing, which fits anchor 4 (good keyword coverage; a few natural terms missing) rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche: a proprietary workflow name (Comet Classic), an explicit slash-command invocation, and runtime-specific triggers (resume-probe returning auto_resume, unarchived Classic change) that no other skill would match. This matches anchor 5 (clear niche with distinct triggers; minimal conflict risk).

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

rpamis/comet

Path

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