CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-any

Inspect Skills for a goal and author the complete entry Skill and business Rule for Native extensions, Classic compositions, or standalone applications; after confirmation, the SDK assembles Runtime, connects Hooks, and previews installation. Not for general Skill cleanup or review.

Quality

70%

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

Quality

Content

70%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 presents an exceptionally well-gated multi-stage workflow with explicit validation checkpoints, user-approval gates, and failure-recovery loops, all in a compact form. Its main weaknesses are the absence of the referenced sdk-creation.md file from the bundle (breaking both navigation and the deferred command/structure details) and prose so compressed that some instructions read as jargon-heavy run-ons.

Suggestions

Ship the referenced 'reference/sdk-creation.md' (or inline the 'documents' structure and the decision/revise submission commands) so the deferred key details are actually reachable from the bundle.

Show the exact commands for submitting a user decision, revise, and confirm-plan/confirm-eval/confirm-install, not just the discovery-phase commands, so every stage is executable from the body.

Break up compressed run-on sentences (e.g., the 'Start or resume' step 1) into separate imperative steps to reduce re-reading and remove the repeated 'Preserve the current work' boilerplate.

DimensionReasoningScore

Conciseness

The body is dense and free of explanations of concepts Claude already knows, with every section carrying operational content; however, repeated phrases ('Preserve the current work' appears four times, 'explicitly approves' three times) and compressed run-on sentences (e.g., 'Preserve the original name and Run; after interruption, inspect the original Action and do not repeat completed work.') could be trimmed or split. Not 5 because of this repetition and over-compression; not 3 because there is no real padding.

4 / 5

Actionability

The main loop is concretely executable ('comet creator status <name> --project <project> --json', 'comet creator start <name> --project <project> --goal <user-goal> --install-target <relative-directory> --host codex|claude-code --json'), but the commands for submitting decisions, revising, and the critical 'documents' structure are never shown — they are deferred to 'reference/sdk-creation.md', which is not present in the bundle, leaving key details unavailable. Not 4 because these gaps are more than minor; not 2 because the primary workflow commands are fully specified with flags.

3 / 5

Workflow Clarity

The multi-stage sequence (start/resume → analysis and plan → confirmation/validation/delivery → recovery boundaries) is explicit, with validation checkpoints at every gate: user approval of the plan, artifact checks that 'must pass before installation', eval review with retry/revise/skip choices, and install preview approval. Feedback loops are explicit ('On failure, preserve the current work, correct the plan or artifacts, and resume the original Action') and a dedicated Recovery boundaries section covers error handling. This matches the top anchor: clear sequence, explicit validation, and error-recovery loops.

5 / 5

Progressive Disclosure

The ~48-line body is well sectioned and defers detail via clearly signaled, one-level-deep references ('Before the first claim or action submission, read [Creation actions and recovery](reference/sdk-creation.md)'), but that referenced file does not exist in the bundle — no references/, scripts/, or assets/ directories are present — so navigation to the deferred material is broken. Not 4 because a missing referenced file is more than a minor organization gap; not 2 because the in-body structure itself is good and references are clearly signaled rather than buried.

3 / 5

Total

15

/

20

Passed

Description

58%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 clearly communicates a niche, multi-part capability with a useful negative boundary, but it is written in dense platform jargon and lacks any positive trigger guidance for when to invoke it. Adding an explicit 'Use when…' clause with natural user phrasing would materially improve it.

Suggestions

Add a positive trigger clause such as 'Use when the user wants to create, compose, or package a comet application or extension' so the 'when' is explicit, not just the negative boundary.

Replace or gloss platform jargon ('Native extensions', 'Classic compositions', 'Runtime') with plain-language equivalents so the actions are understandable to a user who has not read the SDK docs.

Include natural trigger synonyms users would actually say (e.g., 'build an app', 'author a skill', 'package an extension') to improve keyword coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Inspect Skills for a goal and author the complete entry Skill and business Rule', 'the SDK assembles Runtime, connects Hooks, and previews installation' — but wraps them in unexplained platform jargon ('Native extensions, Classic compositions'), leaving coverage of what authoring concretely involves partially opaque. Not 5 because the internal terminology obscures the actions; not 3 because multiple distinct actions are explicitly stated.

4 / 5

Completeness

The 'what' is clear (inspect Skills, author entry Skill and business Rule, SDK assembles Runtime/previews installation), but there is no positive 'Use when…' clause — only the negative boundary 'Not for general Skill cleanup or review'. Per the judging guideline, a missing 'Use when…' or equivalent explicit positive trigger guidance caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ('Skills', 'business Rule', 'extensions', 'applications', 'installation'), but the phrasing is dominated by platform-specific jargon rather than natural user language; common variations a user would actually say (e.g., 'create/build a comet app', 'make an extension') are missing. Not 2 because there are more than one or two relevant keywords; not 4 because natural phrasing is largely absent.

3 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (comet creator application authoring across 'Native extensions, Classic compositions, or standalone applications') and the explicit exclusion 'Not for general Skill cleanup or review' reduces conflict. Not 5 because terms like 'Skills' and 'author' carry minor overlap risk with generic skill-authoring guidance.

4 / 5

Total

14

/

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