CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

comet-tweak

使用 Classic 预设流程完成单个 change 的轻量调整。在用户明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak 时使用。

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 strong instruction-only runbook: highly actionable CLI commands with defined placeholders, a clearly sequenced four-phase workflow with explicit validation checkpoints, and genuine error-recovery and escalation feedback loops. Token efficiency is good apart from a duplicated continuation-reuse rule and some overly dense run-on steps. The main structural caveat is that every detail reference points to sibling-skill files that are not part of this bundle, so none can be verified locally.

DimensionReasoningScore

Conciseness

The body is dense operational prose with no padding and no explanations of concepts Claude already knows, fitting 'Efficient; minor instances of over-explanation that could be trimmed'. The continuation-reuse rule ('优先复用 agent.continuation / data.nextAction… 仅在冷恢复、外部状态变化或缺少必要信息时补读') is stated twice (SDK Run 路径 intro and the paragraph after step 4), and steps 1-2 are long run-on sentences that could be tightened, keeping it below anchor 5.

4 / 5

Actionability

The guidance is fully executable with concrete, copy-paste-ready commands and defined placeholders throughout: 'comet classic workspace prepare <name> --isolation <selected-isolation> --json', 'comet guard <change-name> open --apply --approval-hash <approvalHash>', 'comet state propose-escalation <change-name> --reason "<reason>"', 'comet state decide-escalation … --choice <continue|upgrade>', 'comet guard <change-name> build --apply -- <program> [args...]'. This matches anchor 5's 'copy-paste ready code or commands; specific examples cover the common cases' — as an instruction-only orchestration skill, its guidance is maximally actionable.

5 / 5

Workflow Clarity

The SDK Run path gives a clearly numbered Open→Build→Verify→Archive sequence with explicit validation checkpoints (preview then apply with approval hash, re-preview after artifact changes, '--apply 会重新校验当前任务、配置、工作区和证据'), explicit error-recovery loops ('失败后使用返回的当前状态…不重播结果未明的 Action', reconcile recovery), and an escalation decision workflow with user confirmation — matching anchor 5's 'Clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

Structure is good: the SKILL.md is an orchestration overview that delegates detail to clearly signaled, one-level-deep, section-anchored references ('../comet-classic/reference/sdk-methods.md#阶段入口与恢复', 'reference/compat.md', '../comet/reference/change-walkthrough.md'), matching anchor 4's 'Good structure; most content appropriately placed; references mostly clear'. It falls short of anchor 5 because all referenced files live in sibling skills and none are present in this bundle — including the self-relative 'reference/compat.md' — so reference targets cannot be verified, and steps 1-2 pack several procedures into dense paragraphs that could be better organized.

4 / 5

Total

18

/

20

Passed

Description

73%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 and explicitly states when to use the skill with concrete, distinct trigger phrases gated on explicit invocation, giving it minimal conflict risk. Its main weakness is the 'what': a single high-level action ('轻量调整') with no enumerated concrete capabilities, which limits specificity. Trigger coverage is good within its niche but lacks common synonyms.

Suggestions

Enumerate 2-3 concrete capabilities in the description (e.g., creates OpenSpec changes with delta specs, runs guarded build/verify/archive phases, handles escalation to the full flow) instead of the generic '完成单个 change 的轻量调整', to raise specificity.

Add natural trigger synonyms such as 微调/小改动 (minor tweak, small change) alongside 'tweak' so users phrasing lightweight-change requests without the exact keyword still match.

Briefly state the boundary against /comet-classic (e.g., '不需要完整设计与实施计划时使用') to sharpen the 'what' and further reduce overlap with the full-flow skill.

DimensionReasoningScore

Specificity

The description names its domain concretely ('使用 Classic 预设流程完成单个 change 的轻量调整' — lightweight single-change adjustments via the Classic preset flow) but offers only one high-level action, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is above anchor 2 because the scope (single change, preset flow, lightweight) is concrete rather than generic, but below anchor 4 because no specific capabilities (e.g., delta specs, guarded build/verify, escalation handling) are enumerated.

3 / 5

Completeness

Both parts are present: 'what' ('完成单个 change 的轻量调整' via the Classic preset flow) and an explicit 'when' clause ('在用户明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak 时使用') with concrete trigger phrases. It sits between anchors 4 and 5: the 'when' is fully explicit, but the 'what' is a single high-level action without the concrete capability list of the anchor-5 example, so 4 fits best.

4 / 5

Trigger Term Quality

Triggers are explicit and natural for this skill's invocation model: '明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak' covers command invocation, selection, and resume. This fits 'Good keyword coverage; a few natural terms missing' — common phrasings a user might say such as 微调/小改动 (minor tweak) are absent, keeping it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Triggering is gated on explicit invocation ('用户明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak'), creating a clear niche with distinct triggers and minimal overlap risk against sibling Comet skills (full classic flow, design, verify, archive). This matches anchor 5; it is not anchor 4 because no plausible mis-trigger path is left open by the explicit-invocation gating.

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

Warning

Total

15

/

16

Passed

Repository

rpamis/comet

Path

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