Agent skill

Publish UI Package Release

by cline in cline/cline

Validates and publishes the standalone @cline/ui npm package through its own release workflow, separate from the Cline SDK runtime packages.

Apache-2.0Auto-check passedDevOps & Cloud

Install Publish UI Package Release

skills CLI
$ npx skills add cline/cline --skill publish-ui -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cline/cline publish-ui --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cline/cline.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cline/skills/publish-ui .claude/skills/publish-ui && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
publish-ui
GitHub stars
70k
Token cost
~1.4k tokens
SKILL.md length
516 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Validates and publishes the standalone @cline/ui npm package through its own release workflow, separate from the Cline SDK runtime packages.

  • Works in 3 steps: Inspect the branch, current version, npm… → Ask for the npm channel and version… → Validate the release candidate.
  • Bumping and publishing a new @cline/ui version
  • SKILL.md covers Release contract, Normal release, One-time npm bootstrap and Final report
  • Calls npm, bun and git

What it does

This skill releases @cline/ui on its own cadence rather than alongside the Cline SDK runtime packages. The package's version lives in a workspace package.json, the actual publish happens through a manually dispatched workflow, and latest is the production npm tag while next is an explicit prerelease-only preview tag.

A normal release checks the branch, current version and npm state, asks for the channel and exact version bump rather than guessing, runs the UI package's typecheck and test suite along with a packed-tarball install test under both newer and older React, commits the version bump separately from feature work, and only then talks through dispatching the workflow with an explicit publish confirmation from the main branch.

Every step that pushes a commit, triggers the publish workflow, changes npm trust settings, or runs a local publish command waits for an explicit go-ahead first, since npm versions are immutable and can never be republished once they land.

When your agent uses it

  • Bumping and publishing a new @cline/ui version
  • Publishing a preview build of @cline/ui under the next tag
  • Checking whether @cline/ui is ready to release

Example prompts

  • “Bump @cline/ui to the next patch version and publish it to latest.”
  • “Publish a 0.2.0-next.0 preview build of the UI package.”
  • “Is @cline/ui ready to ship? Run the release checks.”

Requirements

  • npm publish access to @cline/ui
  • Bun for running the package's checks

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the branch, current version, npm state, and UI changes.
  2. Ask for the npm channel and version together. For latest, ask for patch,
  3. Validate the release candidate.

What it can do on your machine

Read from SKILL.md and the folder at commit fa840c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • bun
    • git
    • gh
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Publish UI Package Release loads about 1.4k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 516 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cline/cline at commit fa840c7, republished under its Apache-2.0 licence (© cline). 516 words, ~1,366 tokens.

Download SKILL.mdSave it as .claude/skills/publish-ui/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
publish-ui
description
Prepare, validate, and publish standalone @cline/ui npm releases. Use when bumping the UI package version, publishing latest or next through ui-publish.yml, checking UI release readiness, or completing the one-time npm trusted-publishing bootstrap.

Publish UI

Release @cline/ui independently from the Cline SDK runtime packages.

Release contract

  • Version source: sdk/packages/ui/package.json.
  • Workflow: .github/workflows/ui-publish.yml.
  • The package keeps internal: true only to stay out of the SDK's shared version/publish scripts. It is still a public npm package because private: false and publishConfig.access: public control npm publication.
  • latest is the production channel. next is an opt-in preview channel.
  • Use prerelease versions such as 0.2.0-next.0 for next; do not publish a version intended for latest under the preview tag because npm versions cannot be republished.
  • There is no UI Git tag, GitHub release, schedule, or Slack announcement.
  • The workflow runs only by manual dispatch. Every release attempt runs the UI quality checks before publishing and requires confirm_publish=publish from main.
  • The publish job and npm trust relationship use the protected Publish environment.
  • Every npm publication needs a new semver version; npm versions are immutable.
  • Always ask before pushing commits, triggering the publish workflow, changing npm trust settings, or running a local publish command.

Normal release

  1. Inspect the branch, current version, npm state, and UI changes.
sh
git status --short --branch
node -p "require('./sdk/packages/ui/package.json').version"
npm view @cline/ui dist-tags versions --json
git log --oneline --no-merges -- \
  sdk/packages/ui apps/examples/desktop-app/webview/components/views/chat \
  .github/workflows/ui-publish.yml
  1. Ask for the npm channel and version together. For latest, ask for patch, minor, major, or an explicit version. For next, require an explicit prerelease version such as 0.2.0-next.0. Do not guess. Update only sdk/packages/ui/package.json and its workspace version in bun.lock. Do not run the SDK version command.

  2. Validate the release candidate.

sh
bun install --filter @cline/ui --filter @cline/code --frozen-lockfile
bun -F @cline/ui typecheck
bun -F @cline/ui test
bun -F @cline/ui test:package
bun -F @cline/ui build-storybook
bun -F @cline/code test:chat-ui

The packed-package test installs the tarball with Bun/React 19 and with npm/Node/React 18. Inspect bun pm pack --dry-run when the exported file set changed.

  1. Commit the version bump separately from feature work. Ask before pushing.
sh
git add sdk/packages/ui/package.json bun.lock
git commit -m "chore(ui): release vX.Y.Z"
git push origin HEAD
  1. After the release commit reaches main, restate the selected npm tag and ask for explicit publish approval. Then trigger and watch the standalone workflow:
sh
run_url=$(gh workflow run ui-publish.yml --ref main \
  -f npm_tag=latest \
  -f confirm_publish=publish)
test -n "$run_url"
run_id=${run_url##*/}
gh run watch "$run_id" --exit-status

Use npm_tag=next only for a deliberate preview. Do not report success until the workflow succeeds and npm shows the exact version under the selected tag.

sh
npm view @cline/ui dist-tags versions --json
Show full SKILL.md (200 more words)Show less

One-time npm bootstrap

Use this only while npm view @cline/ui returns E404. npm requires the package to exist before its GitHub trusted publisher can be configured.

  1. Merge the package and ui-publish.yml to main. Start from a clean, reviewed main checkout. Verify authentication, account 2FA, and write access to the @cline npm organization. The npm trust command in step 4 requires npm CLI 11.15 or newer; the automated trusted-publishing workflow itself enforces npm 11.5.1 or newer.
sh
npm --version
npm whoami
npm view @cline/ui version

If npm is older than 11.15, ask before upgrading with npm install -g npm@^11.15.0.

  1. Run the normal release validation in step 3 above. Then build, pack, test, and inspect the exact initial tarball. Record the absolute archive path printed by the final command.
sh
bun -F @cline/ui build
pack_dir=$(mktemp -d)
(cd sdk/packages/ui && bun pm pack --ignore-scripts --destination "$pack_dir" --quiet)
tarball=$(find "$pack_dir" -maxdepth 1 -name '*.tgz' -print -quit)
test -n "$tarball"
bun sdk/packages/ui/scripts/smoke-package.ts "$tarball"
tar -tzf "$tarball"
printf 'Bootstrap archive: %s\n' "$tarball"
  1. Ask for explicit approval, then publish the initial version publicly under latest:
sh
npm publish /absolute/path/from-step-2.tgz --access public --tag latest
  1. Ask separately before configuring the standalone workflow as the trusted publisher:
sh
npm trust github @cline/ui \
  --repo cline/cline \
  --file ui-publish.yml \
  --env Publish \
  --allow-publish
  1. Verify both package state and trust. Every later release uses the workflow; do not add a long-lived npm token.
sh
npm view @cline/ui dist-tags versions --json
npm trust list @cline/ui

Final report

Report the version and npm tag, release commit, whether anything was pushed, workflow URL or bootstrap result, npm verification, and tests/builds run. If the package still returns E404, state that bootstrap remains required.

© cline, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .cline/skills/publish-ui of cline/cline.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit fa840c7

Compare with similar skills

Publish UI Package Release next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Publish UI Package Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Publish UI Package Release this skillcline/cline70k—~1.4kAutomated safety check: PassApache-2.0
ClickUp CLI Release Processkrodak/clickup-cli121—~906Automated safety check: WarnMIT
GAIA Sidecar Agent Releaseamd/gaia1.6k—~3.6kAutomated safety check: PassMIT
Check Release DeploymentsNVIDIA/NeMo-Relay192—~415Automated safety check: PassApache-2.0
Adf MasterKilo-Org/kilo-marketplace190—~3.2kAutomated safety check: PassMIT
Cicd Playbookmohitagw15856/pm-claude-skills1.4k—~2.9kAutomated safety check: NotesMIT

Similar skills

  • ClickUp CLI Release Process

    krodak/clickup-cli

    Walks through releasing a new version of clickup-cli: pre-release checks, version bump, tagging, CI watch, release notes and the Homebrew update.

    121 GitHub stars~906 tokensUpdated 3 days ago
    DevOps & CloudAuto-check: warnings
  • Walks through releasing a GAIA sidecar agent as a frozen binary plus npm client through the tag-triggered Agent Hub CI pipeline, with a human gate before publishing.

    1.6k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Check Release Deployments

    NVIDIA/NeMo-Relay

    Official

    Verify whether a tagged NeMo Relay release reached GitHub Actions, tagged Go module source, crates.io, PyPI, and npm.

    192 GitHub stars~415 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Adf Master

    Kilo-Org/kilo-marketplace

    Azure Data Factory (ADF) CI/CD, deployment, and pipeline development.

    190 GitHub stars~3.2k tokensUpdated 11 days ago
    DevOps & CloudAuto-check passed
  • Cicd Playbook

    mohitagw15856/pm-claude-skills

    Write a CI/CD pipeline playbook for a service or team. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.9k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Scheduled CI skill that scans a repository for small, certain docs, test and code hygiene issues and fixes them on one branch with a commit per finding.

    28k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed

More from cline/cline

All 8 skills in this repo
  • Cline SDK Guide

    cline/cline

    Reference for building AI agents with the Cline SDK: the Agent runtime, ClineCore sessions, custom tools, plugins, events, providers, scheduling and multi-agent teams.

    70k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Helps build terminal user interfaces with OpenTUI using its core imperative API or its React and Solid reconcilers, with references for layout, keyboard, animation and testing.

    70k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Guides publishing a one-time What's new dialog in the Cline desktop app: deciding if one is due, picking highlights from the changelog and editing one content file.

    70k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Covers preparing, tagging and publishing a Cline desktop app release on the stable, beta or nightly channel through the desktop-publish GitHub workflow.

    70k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Walks through releasing the Cline CLI package to npm: release notes, version bump, matching git tag, and either the GitHub workflow or a local publish.

    70k GitHub stars~3.4k tokensUpdated today
    Auto-check: warnings

Works with

Questions about Publish UI Package Release

What does Publish UI Package Release do?

Validates and publishes the standalone @cline/ui npm package through its own release workflow, separate from the Cline SDK runtime packages. This skill releases @cline/ui on its own cadence rather than alongside the Cline SDK runtime packages.json, the actual publish happens through a manually dispatched workflow, and latest is the production npm tag while next is an explicit prerelease-only preview tag.

When should I use Publish UI Package Release?

Publish UI Package Release fits situations like: bumping and publishing a new @cline/ui version; publishing a preview build of @cline/ui under the next tag; checking whether @cline/ui is ready to release.

How do I install Publish UI Package Release in Claude Code?

Run `npx skills add cline/cline --skill publish-ui -a claude-code`. Or copy the skill folder (.cline/skills/publish-ui in cline/cline) into .claude/skills/publish-ui in your project. Claude Code loads it when a task matches its description.

How do I install Publish UI Package Release in Codex?

Run `npx skills add cline/cline --skill publish-ui -a codex`. Or copy the skill folder (.cline/skills/publish-ui in cline/cline) into .agents/skills/publish-ui in your project. Codex loads it when a task matches its description.

Can I use Publish UI Package Release in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cline/cline --skill publish-ui -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/publish-ui, .gemini/skills/publish-ui, .github/skills/publish-ui and .opencode/skills/publish-ui in your project.

What does Publish UI Package Release need to run?

Going by SKILL.md and its folder, Publish UI Package Release needs the command-line tools its instructions call (npm, bun, git, gh and node). Our summary lists: npm publish access to @cline/ui; Bun for running the package's checks.

Does Publish UI Package Release access the network?

SKILL.md contains no URLs. Its commands use npm, git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Publish UI Package Release safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Publish UI Package Release use?

Publish UI Package Release is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Publish UI Package Release use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Publish UI Package Release?

Skills that share tags, products or a category with Publish UI Package Release: ClickUp CLI Release Process (krodak/clickup-cli, 121 stars), GAIA Sidecar Agent Release (amd/gaia, 1.6k stars), Check Release Deployments (NVIDIA/NeMo-Relay, 192 stars) and Adf Master (Kilo-Org/kilo-marketplace, 190 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Publish UI Package Release?

cline (a GitHub organization) maintains it in cline/cline, which has 70,041 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 9, 2026.

Source: cline/cline on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.