CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-archive

Archive and deliver a Classic change. Use when the user invokes /comet-archive or Classic Runtime enters Archive or resumes delivery.

Quality

84%

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

88%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 dense, highly actionable protocol: exact CLI commands with flags and placeholders, a clearly sequenced 1-5 workflow with validation gates, guard checks, and explicit recovery guidance for interruptions and unknown results. Minor weaknesses are the repetitive restatement of reuse/don't-requery rules across sections and two referenced paths (reference/compat.md, decision-point.md) that do not resolve within this bundle.

DimensionReasoningScore

Conciseness

Every clause carries domain protocol and no concepts Claude already knows are explained, but the reuse/don't-requery rule is restated repeatedly ("do not retrieve repeatedly", "Do not reload the protocol", "Reuse them when already available", "Reuse the latest valid response", "Reuse current valid state"), matching anchor 4 (minor instances that could be trimmed). It is not 5 because a tightened single statement of the reuse policy would remove noticeable redundancy; not 3 because there is no unnecessary explanation or padding beyond that repetition.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with flags and placeholders cover the common cases: "comet state propose-archive <change-name> --summary \"<delivery-summary>\"", "comet state decide-archive <change-name> --proposal-hash <proposalHash> --choice <local|push|pr|reverify|later>", "comet guard <change-name> archive --apply", and "comet state complete-delivery <change-name> --commit <sha>". This matches anchor 5; it is not 4 because the command set is complete for all delivery branches rather than having gaps.

5 / 5

Workflow Clarity

A clearly numbered 1-5 sequence includes explicit validation steps ("Guard checks authorization, branch, and Verify receipts"; complete-delivery "validates the archive commit and approved remote/PR delivery") and feedback loops for error recovery ("After interruption inspect state next --json and --recover"; "On an unknown result, read the remote or PR before retrying"; "On failure preserve the Run and decision and address the reported gap"). This matches anchor 5; the destructive-operation cap does not apply since validation and recovery checkpoints are present throughout.

5 / 5

Progressive Disclosure

The body stays lean by deferring detail to one-level-deep, well-signaled references with explicit read-conditions ("[Task Context and Artifact Language](../comet-classic/reference/scripts.md...)", "[phase entry and recovery](../comet-classic/reference/sdk-methods.md...)"), matching anchor 4 (references mostly clear, minor organization gaps). It is not 5 because "reference/compat.md" and "decision-point.md" are referenced but do not resolve within this bundle (no references/ directory exists), leaving navigation slightly ambiguous.

4 / 5

Total

18

/

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.

The description cleanly states what the skill does and provides an explicit, concrete "Use when" clause covering slash-command invocation and runtime state transitions, with minimal conflict risk thanks to the unique /comet-archive trigger. Its weaknesses are the terse two-verb capability statement and jargon-only trigger terms that lack natural-language variations users might actually say.

Suggestions

Enumerate the concrete delivery actions instead of the generic "deliver" — e.g., "Archive a Classic change and deliver it as a local commit, push, or pull request" — to lift specificity beyond two vague verbs.

Add natural-language trigger phrases users would actually say (e.g., "finish the change", "ship the change", "deliver the change") alongside the slash command and runtime-state triggers, so it fires on conversational requests as well as system events.

Name the key artifacts the skill handles (OpenSpec archive, Design Doc/Plan annotations, walkthrough page) so the "what" conveys scope without relying on the body for detail.

DimensionReasoningScore

Specificity

"Archive and deliver a Classic change" names the domain with exactly two actions ("Archive", "deliver"), matching the anchor for 1-2 concrete actions that are not comprehensive. It is not 4 because "deliver" is generic and no several specific actions (e.g., commit, push, open PR) are enumerated, and not 2 because "archive" is a concrete domain-specific action rather than purely generic.

3 / 5

Completeness

Explicitly answers "what" ("Archive and deliver a Classic change") and "when" with three concrete trigger phrases ("invokes /comet-archive or Classic Runtime enters Archive or resumes delivery"), matching the anchor for clearly answering both with concrete triggers. It is not 4 because the "when" clause is already explicit and specific, leaving no gap that anchor 4 describes.

5 / 5

Trigger Term Quality

Triggers are "/comet-archive", "Classic Runtime enters Archive", and "resumes delivery" — relevant and precise but all system jargon with no natural-language variations or synonyms a user would casually say. This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms") rather than 4, which requires good natural keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The unique slash command "/comet-archive" plus phase-scoped terms ("Classic Runtime", "Archive", "resumes delivery") establish a clear niche with distinct triggers and minimal conflict risk, matching anchor 5. It is not 4 because no overlap with closely related skills is apparent — the triggers are unambiguous within the comet skill family.

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, 3 suspicious

Warning

Total

15

/

16

Passed

Repository

rpamis/comet

Path

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