CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

publish-cli

Use when preparing, tagging, and publishing an apps/cli npm release. Guides changelog drafting, apps/cli/package.json version bumps, cli-vX.Y.Z tags, local npm publishing, and the publish-cli GitHub workflow.

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

77%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.

An exceptionally actionable, well-sequenced release runbook: every step has executable commands, hard approval/validation gates, and genuinely non-obvious operational knowledge (SDK-first ordering, signing behavior, the ignore-scripts trap). Its weaknesses are length — some passages repeat or over-explain — and a fully monolithic structure with no reference files despite content that would split naturally.

Suggestions

Move the ~80-line Step 0 SDK release procedure into a separate reference file (e.g. references/sdk-release.md) and keep a short gated summary in SKILL.md, since it is a distinct sub-process that must complete before the CLI flow starts.

Condense the ignore-scripts known-failure paragraph to the failure signature, the one-command confirmation, and the workaround, cutting the nested explanation of why Bun reads npm's ignore-scripts.

State the SDK-release rationale (hub freshness, release hygiene) once at the top of Step 0 instead of restating it in step 1's intro and again in step 7's wait explanation.

DimensionReasoningScore

Conciseness

Most content is dense, non-obvious repo-specific fact (hub buildId respawn mechanics, PublishNPM approval gating, the ignore-scripts test failure), but the ignore-scripts paragraph is a very long run-on explanation, the SDK-release rationale is restated across Step 0's intro, step 1, and step 7, and 'ask before pushing' recurs several times. Mostly efficient but could be tightened — matching the 3 anchor rather than the 4 anchor's 'minor instances'.

3 / 5

Actionability

Every step ships copy-paste-ready commands with exact arguments and paths: 'gh workflow run cli-publish.yml -f publish_target=main -f git_tag=cli-vX.Y.Z -f confirm_publish=publish', 'bun release cli', 'git tag -a cli-vX.Y.Z -m "CLI vX.Y.Z"', 'bun -F @cline/cli typecheck'. Fully executable guidance covering the common cases including alternate dist-tags and nightly forcing.

5 / 5

Workflow Clarity

A clearly sequenced flow (Step 0 gate, then steps 1–9) with explicit validation checkpoints: tiered pre-commit verification in step 6, 'Present the draft and wait for approval before editing files', 'gh run watch <run-id> --exit-status' as a hard gate before the CLI release, and a documented known-failure with a confirmation procedure and two workarounds. Error recovery and approval loops are present throughout for destructive/batch operations (pushing tags, publishing).

5 / 5

Progressive Disclosure

No bundle files exist and all ~270 lines live inline in SKILL.md. Section headers are clear and repo-file references (apps/cli/DISTRIBUTION.md, .github/actions/sign-windows-cli) are well signaled, but the entire ~80-line SDK release procedure and the long ignore-scripts troubleshooting passage are inlined content that would be better split into separate reference files. 'Some structure but could be better organized' fits better than the 4 anchor's 'minor organization gaps'.

3 / 5

Total

16

/

20

Passed

Description

83%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 strong description: concrete, file- and workflow-specific capabilities paired with an explicit 'Use when' clause, all in third person with no fluff. The main improvement opportunity is broadening the trigger phrasing to cover more natural variations users might say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'changelog drafting, apps/cli/package.json version bumps, cli-vX.Y.Z tags, local npm publishing, and the publish-cli GitHub workflow' — with specific file paths, tag formats, and workflow names rather than generic language.

5 / 5

Completeness

Both are explicit: what ('Guides changelog drafting... local npm publishing, and the publish-cli GitHub workflow') and when ('Use when preparing, tagging, and publishing an apps/cli npm release'). The when clause is a single framing rather than the varied concrete trigger phrases of the 5 anchor ('or when the user mentions...'), so it sits at 4 — both present, when could be more varied.

4 / 5

Trigger Term Quality

Natural phrases like 'publishing', 'npm release', 'changelog', 'version bumps', and 'tagging' are present and would be said by users, but common variations such as 'release notes', 'ship the CLI', or 'nightly' are missing. Not the 5 anchor, which requires comprehensive synonym coverage; clearly above the 3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

'apps/cli npm release' and 'publish-cli GitHub workflow' carve a clear niche with distinct triggers; only the most minimal overlap risk exists with a hypothetical sibling SDK-publishing skill, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

18

/

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

cline/cline

Path

.cline/skills/publish-cli/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.