CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-build

Plan, implement, and accept Classic tasks. Use when the user invokes /comet-build or Classic Runtime enters Build or returns to Build for repairs.

Quality

73%

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

Quality

Content

73%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 content is a strongly operational, well-sequenced Build-phase playbook with exact CLI commands, explicit validation gates, and genuine error-recovery loops. Its main costs are run-on sentence density and repeated state-reuse reminders that inflate tokens, plus one broken in-bundle reference (reference/compat.md).

Suggestions

Break the multi-directive paragraphs (especially the full.build.configure and workflow-routing steps) into short imperative bullets and deduplicate the state-reuse guidance stated after step 4 and again in surrounding paragraphs.

Fix or relocate the broken "reference/compat.md" link, and standardize in-bundle vs cross-bundle reference paths so every target is verifiable.

Make vague directives actionable: specify how to resolve drift before complete-build and what evidence identifies the repair path when a guard check fails.

DimensionReasoningScore

Conciseness

The body teaches no known concepts and is all operational directives, but it is padded with very long compound sentences (the full.build.configure step packs seven directives into one paragraph) and repeats state-reuse guidance roughly three times ("Do not repeat next, select, or check while state is valid", "read again only on a cold resume", "Reuse them when already available"). This matches the anchor of mostly efficient but could be tightened, not the 4-level of only minor trims.

3 / 5

Actionability

Most guidance is executable with exact commands and flags ("comet state propose-build <change-name> --file <configuration-json> --confirmed", "comet guard <change-name> build --apply -- <program> [args...]"). It falls short of 5 because some placeholders (<builder-execution-ref>, <plan-ref>) and vague directives ("Resolve drift before submission", "repair the cause") depend on external references or leave the exact procedure unspecified.

4 / 5

Workflow Clarity

The four numbered steps give a clear configure → plan → execute → check sequence with explicit validation ("--apply revalidates current tasks, configuration, workspace, and evidence", "Only valid successful evidence advances to Verify") and explicit feedback loops (rejection → "Propose revised choices after rejection"; failure → "repair the cause from the returned current Build Action"; interrupted receipt → "investigate the Action and check record before re-executing anything"). This matches the top anchor of clear sequencing with validation checkpoints and error-recovery loops.

5 / 5

Progressive Disclosure

The body is a lean overview that keeps protocol detail behind clearly signaled, one-level-deep section-anchored links ("../comet-classic/reference/sdk-methods.md#build", "../comet/reference/change-walkthrough.md"). It is not a 5 because the bundle contains no reference files at all, so "reference/compat.md" is a broken in-bundle path and the cross-bundle "../comet/..." targets cannot be verified from this skill.

4 / 5

Total

16

/

20

Passed

Description

62%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 correctly pairs a what-statement with an explicit, multi-condition Use-when clause and is well-scoped to its niche. Its weaknesses are terse, generic action verbs on the what-side and trigger terms that lean on internal Runtime jargon rather than phrases a user would naturally say.

Suggestions

Expand the what-clause with concrete actions, e.g. "Configure build modes, submit and approve build plans, implement tasks, and run acceptance checks for Classic changes".

Add natural-language trigger variations users might actually type, such as "build the change", "run the build phase", or "repair a failed Classic build", alongside the /comet-build command and Runtime-state triggers.

Clarify what "accept Classic tasks" means (e.g. validating evidence and recording acceptance receipts) so the deliverable is unambiguous.

DimensionReasoningScore

Specificity

"Plan, implement, and accept Classic tasks" names the domain and three verbs, but the actions are generic with no detail on what any of them concretely involve, matching the anchor for domain plus 1-2 concrete actions that are not comprehensive. It is not a 4 because the verbs lack the specificity of examples like "extracts text, fills forms, converts pages to images".

3 / 5

Completeness

Both parts are present: the what ("Plan, implement, and accept Classic tasks") and an explicit when ("Use when the user invokes /comet-build or Classic Runtime enters Build or returns to Build for repairs") with concrete triggers. It falls short of 5 because the what-side is thin — "accept Classic tasks" leaves the actual deliverables vague.

4 / 5

Trigger Term Quality

"Use when the user invokes /comet-build or Classic Runtime enters Build or returns to Build for repairs" provides real trigger terms, but they are largely system-state jargon ("Classic Runtime enters Build") and miss natural user phrasings like "build the change" or "classic build". It fits the anchor of some relevant keywords missing common variations, not the 4-level of good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

"comet-build", the "Build" phase, and "Classic Runtime" carve a clear niche with distinct triggers, giving minimal conflict risk outside the comet suite. It is not a 5 because "Plan, implement, and accept Classic tasks" plausibly overlaps with sibling comet phase skills (planning or verification skills in the same family).

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: 1 missing, 5 suspicious

Warning

Total

15

/

16

Passed

Repository

rpamis/comet

Path

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