CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet

Comet workflow entry. Use when the user invokes /comet or asks to use Comet without choosing Native or Classic; load Native or Classic from project configuration.

Quality

87%

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

85%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 tight, well-structured router skill: the core workflow is fully sequenced with explicit error-handling and schema-validation checkpoints, and commands are concrete enough to execute directly. The only flaws are minor redundancy in the step-3 bullets and one ellipsis placeholder ('comet task ... --json') that keeps actionability just short of fully copy-paste ready.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no concept-explanation padding ("Run the Comet CLI installed on PATH", "Parse the JSON. Only accept `schema: comet.workflow-resolution.v1`"), but the bullets under step 3 redundantly repeat 'Execute immediately: Use the Skill tool to load the `comet-native` skill. Do not skip this step' after the step lead-in already instructs it, and 'Later changes to global defaults do not overwrite this project's saved configuration' is an explanatory aside. This matches anchor 4 (efficient, minor instances that could be trimmed) rather than 5, and is clearly above anchor 3 since there is no unnecessary explanation of things Claude already knows.

4 / 5

Actionability

Mostly executable, concrete guidance: the copy-paste command 'comet workflow resolve . --activate --json', the exact schema token 'comet.workflow-resolution.v1', fully enumerated outcome flags '--outcome used-successfully|ignored|overridden|corrected|contributed-to-failure', and explicit error branches ('On `command not found`... stop and report'). It falls short of anchor 5 only because 'comet task ... --json' uses an ellipsis placeholder rather than a complete command; it is well above anchor 3 since real commands and flags dominate over pseudocode.

4 / 5

Workflow Clarity

A clear numbered 1-2-3 sequence with comprehensive, explicit validation checkpoints: schema acceptance ('Only accept `schema: comet.workflow-resolution.v1` and one of the two `skill` values'), and distinct error handling for missing CLI ('command not found... stop and report an incomplete Comet CLI installation') and failed runs ('exits nonzero, cannot parse the configuration, or returns invalid JSON... preserve the original error and stop'). This is a single-purpose router skill whose action is unambiguous with no validation gaps, matching anchor 5 rather than anchor 4's 'most checkpoints present'.

5 / 5

Progressive Disclosure

The body is under 50 lines, well organized into a heading, intro, numbered steps, and closing constraints, and needs no external file references — it routes exactly one level deep via the Skill tool to `comet-native`/`comet-classic` and delegates details to those skills. The bundle's 14 `scripts/comet-*.mjs` files are appropriately neither inlined nor referenced by this entry skill, so per the simple-skill scoring note this is a 5, not anchor 4's 'minor organization gaps'.

5 / 5

Total

18

/

20

Passed

Description

82%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, well-scoped description that explicitly states what the skill does and exactly when to use it, with concrete, natural trigger phrases and minimal conflict risk thanks to its tie to the Comet name and slash command. Its only weakness is thin action coverage — a single concrete action ('load Native or Classic from project configuration') rather than a fuller list of what entry involves.

DimensionReasoningScore

Specificity

It names the domain ('Comet workflow entry') and one concrete action ('load Native or Classic from project configuration'), matching the anchor for 'names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not list several specific actions (e.g., resolving the workflow via the CLI or passing the request through), and not a 2 because the named action is concrete and skill-specific rather than generic.

3 / 5

Completeness

It explicitly answers both parts: what ('Comet workflow entry... load Native or Classic from project configuration') and when, with concrete trigger phrases ('Use when the user invokes /comet or asks to use Comet without choosing Native or Classic'). The 'when' clause is more explicit than anchor 4's example ('Use when working with PDF files'), naming specific user behaviors including the disambiguation condition, so it matches anchor 5 while remaining concise.

5 / 5

Trigger Term Quality

It includes the natural phrases a user would actually say — 'the user invokes /comet', 'asks to use Comet', 'without choosing Native or Classic' — giving good keyword coverage per anchor 4. It stops short of anchor 5's comprehensive synonym/variation coverage (e.g., 'run the Comet workflow' or direct Native/Classic requests), but is well above anchor 3 since these are the real invocation phrasings, not just domain keywords.

4 / 5

Distinctiveness Conflict Risk

The triggers are tied to the proprietary 'Comet' name and its /comet slash command, and the description explicitly scopes itself to the case where the user has not chosen Native or Classic, avoiding overlap with those sibling skills. This is a clear niche with distinct triggers and minimal conflict risk, matching anchor 5; anchor 4's 'minor overlap risk with closely related skills' does not apply given the explicit scoping.

5 / 5

Total

17

/

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