New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Self Upgrade

by vellum-ai in vellum-ai/vellum-assistant

Upgrade vellum to the latest version, restart the assistant, and restart the gateway

MITAuto-check passed

Install Self Upgrade

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill self-upgrade -a claude-code

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

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant self-upgrade --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/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/self-upgrade .claude/skills/self-upgrade && 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
self-upgrade
GitHub stars
1.4k
Token cost
~495 tokens
SKILL.md length
219 words
Files
1
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Upgrade vellum to the latest version, restart the assistant, and restart the gateway

  • Works in 4 steps: Record the current version → Install the latest vellum → Restart the gateway → …
  • SKILL.md covers Step 1: Record the current…, Step 2: Install the latest…, Step 3: Restart the gateway and Step 4: Restart the assistant, plus 1 more section
  • Calls bun

What it does

Self Upgrade is an agent skill from vellum-ai/vellum-assistant. Upgrade vellum to the latest version, restart the assistant, and restart the gateway

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants

The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/self-upgrade”

Requirements

  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Record the current version
  2. Install the latest vellum
  3. Restart the gateway
  4. Restart the assistant

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. 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:

    • bun

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

Self Upgrade loads about 495 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 219 words of instructions outside code blocks.

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

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 vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 219 words, ~495 tokens.

Download SKILL.mdSave it as .claude/skills/self-upgrade/SKILL.md (or your agent's skills folder).
name
self-upgrade
description
Upgrade vellum to the latest version, restart the assistant, and restart the gateway
compatibility
Designed for Vellum personal assistants
metadata.emoji
⬆️

You are performing a self-upgrade of the Vellum assistant. Follow these steps in order. Use the bash tool to run each command. Confirm each step succeeds before moving to the next.

Step 1: Record the current version

bash
vellum --version

Save this value to report later.

Step 2: Install the latest vellum

bash
bun install -g vellum@latest

After updating, verify the new version:

bash
vellum --version

Step 3: Restart the gateway

If a gateway process is running, restart it so it picks up any protocol or dependency changes from the new version:

bash
pgrep -f 'vellum-gateway|gateway/src/index.ts' || echo "No gateway process found"

If a gateway PID is found, send it SIGTERM so it drains gracefully:

bash
pkill -TERM -f 'vellum-gateway|gateway/src/index.ts'

Then start the gateway again using whatever method the user's deployment uses (e.g. bun run gateway/src/index.ts, a systemd service, or a container orchestrator). If you are unsure how the gateway is deployed, ask the user.

Step 4: Restart the assistant

Use vellum sleep to stop the running assistant and gateway, then vellum wake to start them again from the updated binary:

bash
vellum sleep && vellum wake

Verify it is running:

bash
vellum ps

Important: This is the last step because the current assistant process is the one executing this conversation. After the restart, the new assistant takes over and this conversation ends gracefully.

After Upgrade

Report back to the user with:

  • The previous and new vellum version
  • Assistant status (running, PID)
  • Gateway status (restarted or not found)
  • Any errors encountered during the process

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

Files

Just SKILL.md in skills/self-upgrade of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Self Upgrade 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.

Self Upgrade compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Self Upgrade this skillvellum-ai/vellum-assistant1.4k—~495Automated safety check: PassMIT
gstack Upgradegarrytan/gstack136k—~5.5kAutomated safety check: NotesMIT
Upgrade Browserflutter/flutter179k—~1.1kAutomated safety check: PassBSD-3-Clause
Odoo Upgrade Advisorsickn33/agentic-awesome-skills47k2 repos~1.3kAutomated safety check: PassMIT
Upgrade Mediabunnyremotion-dev/remotion63k—~258Automated safety check: PassCustom licence
Logseq Dependency Upgradelogseq/logseq45k—~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • gstack Upgrade

    garrytan/gstack

    Upgrades an installed gstack to the latest version, handling global and vendored installs, optional auto-upgrade and snooze, and showing what is new.

    136k GitHub stars~5.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Upgrade Browser

    flutter/flutter

    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests.

    179k GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed

  • Odoo Upgrade Advisor

    sickn33/agentic-awesome-skills

    Step-by-step Odoo version upgrade advisor: pre-upgrade checklist, community vs enterprise upgrade path, OCA module compatibility, and post-upgrade validation.

    47k GitHub starsUsed in 2 repos~1.3k tokens
    DevelopmentAuto-check passed

  • Upgrade Mediabunny

    remotion-dev/remotion

    Official

    Upgrade Mediabunny and related @mediabunny packages across the Remotion repo.

    63k GitHub stars~258 tokensUpdated yesterday
    Media & CreativeAuto-check passed

  • Logseq Dependency Upgrade

    logseq/logseq

    Audit, plan, and refresh dependency upgrades for the Logseq repository by scanning every non-gitignored package.json, deps.edn, bb.edn and nbb.edn manifest, checking latest upstream versions…

    45k GitHub stars~1.1k tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Pnpm Upgrade Package

    langfuse/langfuse

    Upgrade pnpm workspace dependencies to target/latest versions: direct/transitive bumps, release-age checks, temporary overrides, minimumReleaseAgeExclude, lockfile/dedupe verification.

    36k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo

  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed

  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed

  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes

  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Questions about Self Upgrade

What does Self Upgrade do?

Upgrade vellum to the latest version, restart the assistant, and restart the gateway. Self Upgrade is an agent skill from vellum-ai/vellum-assistant.

How do I install Self Upgrade in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill self-upgrade -a claude-code`. Or copy the skill folder (skills/self-upgrade in vellum-ai/vellum-assistant) into .claude/skills/self-upgrade in your project. Claude Code loads it when a task matches its description.

How do I install Self Upgrade in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill self-upgrade -a codex`. Or copy the skill folder (skills/self-upgrade in vellum-ai/vellum-assistant) into .agents/skills/self-upgrade in your project. Codex loads it when a task matches its description.

Can I use Self Upgrade 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 vellum-ai/vellum-assistant --skill self-upgrade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-upgrade, .gemini/skills/self-upgrade, .github/skills/self-upgrade and .opencode/skills/self-upgrade in your project.

What does Self Upgrade need to run?

Going by SKILL.md and its folder, Self Upgrade needs the command-line tools its instructions call (bun). Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Self Upgrade access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Self Upgrade 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 Self Upgrade use?

Self Upgrade is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Self Upgrade use?

About 495 tokens (SKILL.md is roughly 2k 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 Self Upgrade?

Skills that share tags, products or a category with Self Upgrade: gstack Upgrade (garrytan/gstack, 136k stars), Upgrade Browser (flutter/flutter, 179k stars), Odoo Upgrade Advisor (sickn33/agentic-awesome-skills, 47k stars) and Upgrade Mediabunny (remotion-dev/remotion, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Self Upgrade?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

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