Agent skill

Upgrade Agent Native

by BuilderIO in BuilderIO/agent-native

Bring an older Agent-Native app or workspace current. An agent skill from BuilderIO/agent-native.

No licenceAuto-check passed

Install Upgrade Agent Native

skills CLI
$ npx skills add BuilderIO/agent-native --skill upgrade-agent-native -a claude-code

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

GitHub CLI
$ gh skill install BuilderIO/agent-native upgrade-agent-native --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/BuilderIO/agent-native.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/upgrade-agent-native .claude/skills/upgrade-agent-native && 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
upgrade-agent-native
GitHub stars
7.1k
Token cost
~1.5k tokens
SKILL.md length
654 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
None found

At a glance

Bring an older Agent-Native app or workspace current. An agent skill from BuilderIO/agent-native.

  • Works in 5 steps: Preview migration codemods first → Apply the reviewed upgrade and codemods → Pull upstream template changes… → …
  • Updating @agent-native/core
  • SKILL.md covers Rule, Why, How and Don't, plus 1 more section
  • Calls pnpm and npx

What it does

Upgrade Agent Native is an agent skill from BuilderIO/agent-native. Bring an older Agent-Native app or workspace current. Use when updating @agent-native/core, fixing a broken upgrade, or when tempted to patch or override core/dispatch packages to make an old branch run.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with pnpm. The repository describes itself as: A framework for building agentic apps.

When your agent uses it

  • Updating @agent-native/core
  • Fixing a broken upgrade
  • Tempted to patch
  • Override core/dispatch packages to make an old branch run

Example prompts

  • “/upgrade-agent-native”

Requirements

  • Node.js

Workflow steps

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

  1. Preview migration codemods first
  2. Apply the reviewed upgrade and codemods
  3. Pull upstream template changes (optional, separate from the bump)
  4. If upgrade or typecheck fails
  5. Dry-run / partial runs

What it can do on your machine

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

    • pnpm
    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm and npx, 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

Upgrade Agent Native loads about 1.5k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 654 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 654 words (~1,506 tokens).

“When an older Agent-Native app/branch needs to run on current packages, use agent-native upgrade. Never "fix" upgrade breakage with pnpm patch, pnpm patch-commit, pnpm.patchedDependencies, pnpm.overrides, patchedDependencies, resolutions, local patch artifacts, or edits under node_modules/@agent-native/* — especially not against @agent-native/core or…”

— opening of SKILL.md by BuilderIO
name
upgrade-agent-native
scope
dev
metadata.internal
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/upgrade-agent-native of BuilderIO/agent-native.

Open the folder on GitHubat commit e16da0c

Compare with similar skills

Upgrade Agent Native 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.

Upgrade Agent Native compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Upgrade Agent Native this skillBuilderIO/agent-native7.1k—~1.5kAutomated safety check: PassNone
Tabler Upgrade Guide Writertabler/tabler42k—~1.7kAutomated safety check: PassMIT
Migrate to Denodenoland/skills100—~2.2kAutomated safety check: WarnMIT
Dep Lib Reviewmizchi/skills356—~1.8kAutomated safety check: PassNone
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT

Similar skills

  • Writes the upgrade guide page for a Tabler release by collecting removed, renamed and deprecated items from changesets and diffs, with before and after examples.

    42k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Migrate to Deno

    denoland/skills

    Official

    Moves a Node.js, npm, Yarn, pnpm or Bun project to Deno in reversible steps, starting with Deno as the package manager and changing no code unless needed.

    100 GitHub stars~2.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check: warnings
  • Dep Lib Review

    mizchi/skills

    Periodic dependency review for Node.js/pnpm projects — outdated package triage, security audit, update batching strategy (patch/minor/major), validation checklist.

    356 GitHub stars~1.8k tokensUpdated 6 days ago
    SecurityAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    83k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check: notes

More from BuilderIO/agent-native

All 102 skills in this repo
  • Actions

    BuilderIO/agent-native

    How to create and run agent actions. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Client Methods

    BuilderIO/agent-native

    Client method surface rules. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Adding A Feature

    BuilderIO/agent-native

    The four-area checklist every new feature must complete. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Address Feedback

    BuilderIO/agent-native

    Triage feedback from docs, issues, Slack threads, or pasted notes into verified bugs, UX proposals, unclear questions, and skipped noise.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Audit Log

    BuilderIO/agent-native

    Durable, access-scoped, append-only record of who changed what app data, when, and whether it was the agent or a human.

    7.1k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Automations

    BuilderIO/agent-native

    Event-triggered and schedule-triggered automations with natural-language conditions.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Upgrade Agent Native

What does Upgrade Agent Native do?

Bring an older Agent-Native app or workspace current. An agent skill from BuilderIO/agent-native. Upgrade Agent Native is an agent skill from BuilderIO/agent-native. Bring an older Agent-Native app or workspace current.

When should I use Upgrade Agent Native?

Upgrade Agent Native fits situations like: updating @agent-native/core; fixing a broken upgrade; tempted to patch; override core/dispatch packages to make an old branch run.

How do I install Upgrade Agent Native in Claude Code?

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

How do I install Upgrade Agent Native in Codex?

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

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

What does Upgrade Agent Native need to run?

Going by SKILL.md and its folder, Upgrade Agent Native needs the command-line tools its instructions call (pnpm and npx). Our summary lists: Node.js.

Does Upgrade Agent Native access the network?

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

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

No licence was found for Upgrade Agent Native or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Upgrade Agent Native use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Upgrade Agent Native?

Skills that share tags, products or a category with Upgrade Agent Native: Tabler Upgrade Guide Writer (tabler/tabler, 42k stars), Migrate to Deno (denoland/skills, 100 stars), Dep Lib Review (mizchi/skills, 356 stars) and Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upgrade Agent Native?

BuilderIO (a GitHub organization) maintains it in BuilderIO/agent-native, which has 7,087 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 8, 2026.

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