capacitor-app-upgrades

capacitor-app-upgrades is a skill for Claude Code from Cap-go/capgo-skills. It costs 175 tokens per session (1,665 once invoked), scanned A, original, MIT.

A general migration guide for moving a Capacitor app to a newer major version. Capacitor is a tool for packaging web apps as native iOS and Android apps.

In plain words
What is it for?
Use it for multi-version Capacitor upgrades, dependency updates, native-platform checks, and verification after the migration.
Why use it?
It helps coordinate version changes across dependencies and native iOS and Android projects, including upgrades that span several versions.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the capacitor-app-upgrades plugin — 7 skills shipped together

Good fit Use it for multi-version Capacitor upgrades, dependency updates, native-platform checks, and verification after the migration.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cap-go/capgo-skills/capacitor-app-upgrades
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Cap-go/capgo-skills --skill capacitor-app-upgrades
Clone the repo
git clone --depth 1 https://github.com/Cap-go/capgo-skills

Made for: Claude Code.

Or install capacitor-app-upgrades, the plugin that ships this one along with the rest of its 7 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for capacitor-app-upgrades

README.md
[![agentmods](https://agentmods.dev/badge/skills/cap-go/capgo-skills/capacitor-app-upgrades/github.svg)](https://agentmods.dev/skills/cap-go/capgo-skills/capacitor-app-upgrades)
Your own site
<a href="https://agentmods.dev/skills/cap-go/capgo-skills/capacitor-app-upgrades"><img src="https://agentmods.dev/badge/skills/cap-go/capgo-skills/capacitor-app-upgrades/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for capacitor-app-upgrades

Your own site · 80×15
<a href="https://agentmods.dev/skills/cap-go/capgo-skills/capacitor-app-upgrades"><img src="https://agentmods.dev/badge/skills/cap-go/capgo-skills/capacitor-app-upgrades.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 175 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,665 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 11 Oct 2026
  • Snyk pass 15 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00175 $0.01665
Opus 5.5 $0.00070 $0.00666
Sonnet 5.5 $0.00035 $0.00333
Haiku 4.5 $0.00017 $0.00167

Measured 14d ago against content hash 5a45c3e3a52e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

capacitor-app-upgrades scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 14d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/capacitor-app-upgrades/skills/capacitor-app-upgrades/SKILL.md · 83 lines

How it starts

The opening of the file, as written. The whole thing — 83 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Capacitor App Upgrade (router)

Plan and run a Capacitor app upgrade one hop at a time, using the version-specific skill for each hop.

When to Use

TRIGGER when:

  • User wants to upgrade a Capacitor app and the start or target version is unknown or more than one major apart
  • User asks for "the latest Capacitor" (decide stable 8.5.x vs prerelease 9 with them)
  • Xcode 27 builds fail on a Capacitor 8.4-or-older app (needs the 8.5 UIScene step)
  • npx cap migrate failed midway and the user needs to know where they are

Do not use:

  • Plugin library repos -> capacitor-plugin-upgrades
  • Cordova/PhoneGap apps -> cordova-to-capacitor
  • CocoaPods to SPM only -> cocoapods-to-spm

Live Project Snapshot

Current Capacitor packages from package.json: !node -e "const fs=require('fs');if(!fs.existsSync('package.json'))process.exit(0);const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const out=[];for(const section of ['dependencies','devDependencies']){for(const [name,version] of Object.entries(pkg[section]||{})){if(name.startsWith('@capacitor/'))out.push(section+'.'+name+'='+version)}}console.log(out.sort().join('\n'))"

Native and Capacitor config paths: !find . -maxdepth 3 \( -name 'capacitor.config.json' -o -name 'capacitor.config.ts' -o -name 'capacitor.config.js' -o -path './ios' -o -path './android' \)

Version Map (October 2026)

Hop Skill Key requirements after the hop
4 -> 5 capacitor-app-upgrade-v4-to-v5 see skill
5 -> 6 capacitor-app-upgrade-v5-to-v6 see skill
6 -> 7 capacitor-app-upgrade-v6-to-v7 see skill
7 -> 8 capacitor-app-upgrade-v7-to-v8 Node 22, Xcode 26, iOS 15, minSdk 24, SDK 36, AGP 8.13, Gradle 8.14.3
8.x -> 8.5 capacitor-uiscene-migration iOS UIScene lifecycle (SceneDelegate + scene manifest); required by Xcode 27
8.5 -> 9 capacitor-app-upgrade-v8-to-v9 Node 24, Xcode 27, iOS 16, minSdk 26, SDK 37, AGP 9.2.1, Gradle 9.5.1

Capacitor stable is 8.5.x (latest). Capacitor 9 is a prerelease on the next tag (9.0.0-alpha.x): install with @next until 9.0.0 is GA, then @latest. Ask before moving a production app to a prerelease; 8.5 is the safe stopping point and already builds with Xcode 27.

Read the full file on GitHub · 83 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 14d ago Changed · +4 lines · +121 tokens per session 5a45c3e3a52e
  2. 1mo ago First seen · 79 lines · 54 tokens per session scan A e73f4ca55426

Subscribe to this mod's changes

capacitor-app-upgrades is a skill published in the GitHub repository Cap-go/capgo-skills (73 stars, last pushed 7d ago), licensed MIT. It adds 175 tokens to every session and 1,665 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

loom-dart

Dart language expertise for idiomatic, production-quality code.

cosmix/loom · 16 tokens

capacitor-plugins

Guides the agent through installing, configuring, and using Capacitor plugins from six sources — official Capacitor plugins, Capawesome plugins, Capacitor Community plugins, Capacitor Firebase plugins, Capacitor MLKit plugins, and RevenueCat plugins. Covers installation, platform-specific configuration (Android and…

capawesome-team/skills · 101 tokens

ionic-appflow-migration

Guides the agent through migrating an existing Ionic Appflow project to Capawesome Cloud. Imports an Ionic Appflow organization export with the Capawesome CLI apps:import command — apps, signing certificates, environments, live update channels, native configurations, store destinations, build automations, and…

capawesome-team/skills · 196 tokens

capacitor-expert

A comprehensive starting point for AI agents to work with Capacitor. Covers core concepts, CLI, app creation, plugins, framework integration, best practices, storage, security, testing, troubleshooting, upgrading, and Capawesome Cloud (live updates, native builds, app store publishing). Pair with the other Capacitor…

capawesome-team/skills · 76 tokens

capgo-cloud-migration

Guides the agent through migrating an existing Capacitor project from Capgo to Capawesome Cloud. Detects Capgo usage (the @capgo/capacitor-updater plugin, CapacitorUpdater configuration, and @capgo/cli commands in CI/CD) and provides step-by-step migration: replacing the plugin with @capawesome/capacitor-live-update…

capawesome-team/skills · 160 tokens

ionic-expert

A comprehensive starting point for AI agents to work with the Ionic Framework. Covers core concepts, components, CLI, theming, layout, lifecycle, navigation, and framework-specific patterns for Angular, React, and Vue. Pair with the other Ionic skills in this collection for deeper topic-specific guidance like app…

capawesome-team/skills · 71 tokens