CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-classic

Comet Classic workflow entry. Use when the user explicitly invokes /comet-classic, asks to start or resume Classic, or resume-probe returns auto_resume for one unambiguously recoverable active 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/comet-classic/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 tightly written orchestrator skill: near-optimal token efficiency, concrete CLI commands, explicit decision-point and guard checkpoints, and well-signaled one-level-deep references. Its main weaknesses are details deferred to reference files that are missing from the bundle (intent-frame schema, task/knowledge command semantics) and an inconsistent, unverifiable reference path convention.

Suggestions

Inline a minimal CometIntentFrame field list or example in §1 so intent routing is actionable without the missing intent-frame.md.

Fix the inconsistent reference path in §2 (`reference/scripts.md#...` vs `comet-classic/reference/scripts.md` used everywhere else) and verify all 11 referenced files actually ship in the bundle.

Add a compact phase-exit checklist (exit checks pass → read `agent.continuation` → invoke only its next Skill) to consolidate the transition sequence currently spread across §3 and auto-transition.md.

DimensionReasoningScore

Conciseness

The body is dense imperative instruction with no concept explanations and no padding — lines like "proposal records goals and scope; spec defines behavior and acceptance; design_doc points to the single formal technical design" compress an entire artifact model into one line. Every sentence is operational and nothing restates knowledge Claude already has, matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Concrete, copy-ready commands are given for the main paths (`comet classic workspace resolve <change-name> --json`, `comet state select`, `comet resume-probe . --stdin --json`, `comet state transition <name> preset-escalate`) plus a route→Skill dispatch table. It falls short of 5 because key executable details are deferred to reference files absent from this bundle — e.g. "fill a CometIntentFrame" and "run `comet task`" have no inline field list, schema, or output example.

4 / 5

Workflow Clarity

A clear numbered sequence (resolve target/workspace → load phase → complete authorized work) with explicit checkpoints: phase Guards, "phase exit checks", decision points that "block dependent work until the user answers explicitly", preset escalation on changed-file thresholds, and recovery procedures. Not 5 because the control flow for any given situation is scattered across four sections and the compressed phrasing requires re-reading to reconstruct the order.

4 / 5

Progressive Disclosure

The structure is exemplary for a complex skill: an overview that delegates ~11 one-level-deep reference files, each tied to an explicit read trigger ("read Ambient Resume in context-recovery.md", "read the chosen preset's escalation rules"). Docked one level because the referenced files do not exist in this bundle — the `comet-classic/reference/...` paths resolve nowhere and §2 inconsistently uses a different style (`[...](reference/scripts.md#task-context-and-artifact-language)`) — so navigation cannot be verified and the skill is unexecutable as shipped.

4 / 5

Total

17

/

20

Passed

Description

68%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 distinct, precisely triggered description whose "when" clause is exemplary but whose "what" is nearly empty — it says the skill is a workflow entry without naming a single concrete capability. Specificity is the main drag on the score.

Suggestions

Add 2–3 concrete capabilities after the domain, e.g. "Binds the change workspace, routes new or recovered requests, and dispatches each phase (Open → Design → Build → Verify → Archive) to its phase Skill."

Replace the bare "Comet Classic workflow entry" with what the entry actually does — resolve the target and workspace, select or create the change, and load the current phase.

Broaden triggers with natural synonyms such as "continue" or "resume the active change" alongside "start or resume Classic".

DimensionReasoningScore

Specificity

The only capability statement is "Comet Classic workflow entry", which names the domain but gives no concrete actions — the workspace binding, intent routing, phase dispatch, and state recovery the body actually performs are all absent, matching "Names the domain but actions are minimal or generic" (cf. "Processes PDF files"). Not 3 because no concrete action is listed; not 1 because the domain is named and the trigger conditions are operationally precise.

2 / 5

Completeness

The "when" is explicit and excellent — a "Use when..." clause with three concrete trigger conditions — but the "what" is thin: "workflow entry" does not say what the skill does (route intents, bind workspaces, dispatch phases). This is the inverse of the score-3 anchor (clear what, missing when) and below the score-5 anchor (both explicit), landing at "both present, one could be more explicit".

4 / 5

Trigger Term Quality

Good natural coverage for this niche: "invokes /comet-classic", "asks to start or resume Classic", "resume-probe returns auto_resume" are exactly the phrases a user of this system would say. Falls short of 5 because common synonyms like "continue", "resume the active change", or "Classic workflow" are missing.

4 / 5

Distinctiveness Conflict Risk

"Comet Classic", "/comet-classic", and "resume-probe returns auto_resume for one unambiguously recoverable active Classic change" are terms unique to this skill and its sibling comet skills, and the description explicitly scopes itself to the entry invocation. Clear niche with distinct triggers; minimal conflict risk.

5 / 5

Total

15

/

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/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.