capacitor-plugin-upgrade-v6-to-v7

v2026.09.24

Guides the agent through upgrading a Capacitor plugin from v6 to v7. Use when the plugin targets Capacitor 6 and needs the v7 migration path. Do not use for app upgrades, other major versions, or non-Capacitor plugins.

GitHub
Install command
npx skhub add cap-go/capacitor-plugin-upgrade-v6-to-v7
Markdown
SKILL.md

Capacitor Plugin Upgrade v6 to v7

Upgrade a Capacitor plugin from version 6 to version 7.

When to Use This Skill

  • User says the plugin targets Capacitor 6 and must move to v7
  • User wants the exact v6 to v7 migration path
  • User needs v7-specific native and package updates

Live Project Snapshot

Plugin and Capacitor package snapshot: !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=['package.name='+(pkg.name||''),'package.version='+(pkg.version||'')];for(const section of ['peerDependencies','dependencies','devDependencies']){for(const [name,version] of Object.entries(pkg[section]||{})){if(name.startsWith('@capacitor/'))out.push(section+'.'+name+'='+version)}}console.log(out.join('\n'))"

Example and native project paths: !find . -maxdepth 3 \( -path './example-app' -o -path './ios' -o -path './android' \)

Procedure

  1. Start from the injected snapshot and confirm the current Capacitor peer dependency range in package.json.
  2. Update the peer dependency range to Capacitor 7.
  3. Review the v6 to v7 migration notes before editing native files.
  4. Update the example app if it exists.
  5. Run npm install.
  6. Sync and verify the example or test app.

Error Handling

  • If the example app breaks, fix the plugin API or native bridge before moving on.
  • If iOS fails, verify the deployment target for Capacitor 7.
  • If Android fails, verify the Gradle and Java requirements for Capacitor 7.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Not specified

Source path

skills/capacitor-plugin-upgrade-v6-to-v7

Default branch

main

Latest commit

c0afb73

Tree SHA

6a5ef7d