skills

Agent skills for interacting with Capawesome, Capacitor and the Ionic Framework.

Features

• 🤖 Agent-optimized: Every instruction is unambiguous and machine-actionable for AI agents.
• 📱 Cross-platform: Covers both Android and iOS platform specifics.
• 🔄 Capacitor Upgrades: Upgrade Capacitor apps and plugins across major versions (4 → 8).
• 📦 Plugin Setup: Install and configure 160+ Capacitor plugins from official and community sources.
• ☁️ Cloud Integration: Set up native builds, live updates, and app store publishing with Capawesome Cloud.
• 🚀 Automated First: Tries automated upgrade before falling back to manual steps.
• 🐛 Error Handling: Common issues and fixes included in every skill.
• 🔁 Up-to-date: Always supports the latest Capacitor version.
• 🔌 MCP-aware: Detects the hosted Capawesome MCP Server and prefers it for Capawesome documentation.

Missing a feature? Just open an issue and we'll take a look!

MCP Server

Capawesome also offers a hosted MCP Server. It serves the Capawesome documentation straight from the source — so it never goes stale — and, with an API token, the full Capawesome Cloud management API. There is nothing to install and nothing to keep up to date:

https://mcp.capawesome.io/mcp

Add it to Claude Code:

claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp"

The documentation tools need no account and no token. To add the Capawesome Cloud tools, create an API token and use:

claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" \
  --header "Authorization: Bearer YOUR_TOKEN"

For Claude Desktop, Cursor, VS Code, and other MCP clients, see the capawesome-mcp skill.

MCP Server or skills?

Use both — they cover different ground:

	MCP Server	Skills
Capawesome plugin, CLI, and Cloud documentation	✅ always current	✅ bundled
Capacitor Firebase and Capacitor MLKit plugin documentation	✅ always current	✅ bundled
Official Capacitor, Community, and RevenueCat plugins	❌	✅
Capacitor and Ionic upgrade and migration procedures	❌	✅
Ionic Appflow, Ionic Enterprise SDK, and Capgo migrations	❌	✅
Managing Capawesome Cloud apps, builds, and deployments	✅	via the CLI
Works without a network round trip	❌	✅

The skills check for the MCP Server and prefer it for Capawesome documentation whenever it is connected, falling back to their bundled reference files when it is not.

Installation

skills.sh

To install all skills at once, use the skills command:

npx skills add capawesome-team/skills

Claude Code Plugin Marketplace

Alternatively, if you're using Claude Code, you can add the Claude Code Plugin Marketplace and install individual plugins:

claude plugin marketplace add capawesome-team/skills

Available plugins:

Plugin	Description
capacitor-core	App creation, development, upgrades, expert reference, plugin setup, and desktop platforms.
capacitor-integrations	Push notifications (FCM) and in-app purchases.
capacitor-frameworks	Angular, React, and Vue patterns for Capacitor.
capacitor-plugin-dev	Create, upgrade, and add SPM support to Capacitor plugins.
ionic-core	App creation, development, upgrades, and expert reference.
ionic-frameworks	Angular, React, and Vue patterns for Ionic.
capawesome-cloud	MCP server, CLI setup, native builds, live updates, and app store publishing.
ionic-migrations	Migrate from Ionic Appflow and Ionic Enterprise SDK plugins.

Install a plugin:

claude plugin install capacitor-core@capawesome-skills

Update

To regularly update the skills to the latest version, run:

npx skills update

Usage

After installing the skills, you can use them in your agent. Here are some examples...

Upgrade a Capacitor app across major versions:

Upgrade my Capacitor app from version 5 to version 7.

Install and configure any of 160+ supported Capacitor plugins:

Install and configure the @capawesome/capacitor-file-picker plugin in my project.

Set up live updates, native builds, or app store publishing with Capawesome Cloud:

Set up Capacitor Live Updates with Capawesome Cloud in my project.

Set up native builds with Capawesome Cloud for my Capacitor app.

Add push notifications with Firebase Cloud Messaging:

Set up push notifications with Firebase Cloud Messaging in my Capacitor app.

Upgrade a Capacitor plugin to a newer major version:

Upgrade my Capacitor plugin to version 7.

Migrate from Ionic Appflow, Ionic Enterprise SDK plugins, or Capgo:

Migrate my app from Ionic Appflow to Capawesome Cloud.

Migrate my app from Capgo to Capawesome Cloud.

Skills

Capacitor

Skill	Description
capacitor-angular	Angular-specific patterns and best practices for Capacitor app development.
capacitor-app-creation	Create a new Capacitor app from scratch with platform setup and optional integrations.
capacitor-app-development	General Capacitor app development — core concepts, CLI usage, app configuration, troubleshooting, and best practices.
capacitor-app-spm-migration	Migrate a Capacitor app's iOS dependency management from CocoaPods to Swift Package Manager (SPM).
capacitor-app-upgrades	Upgrade a Capacitor app to a newer major version.
capacitor-expert	Comprehensive Capacitor expert reference — core concepts, CLI, plugins, framework integration, best practices, and Capawesome Cloud.
capacitor-in-app-purchases	Set up in-app purchases and subscriptions in Capacitor apps.
capacitor-platforms	Add and use the Capawesome desktop platforms (Electron and Tauri) in Capacitor apps.
capacitor-plugin-development	Create and maintain Capacitor plugins from scratch.
capacitor-plugin-spm-support	Add Swift Package Manager (SPM) support to a Capacitor plugin.
capacitor-plugin-upgrades	Upgrade a Capacitor plugin to a newer major version.
capacitor-plugins	Install, configure, and use Capacitor plugins from official and community sources.
capacitor-push-notifications	Set up and use push notifications in Capacitor apps using Firebase Cloud Messaging.
capacitor-react	React-specific patterns and best practices for Capacitor app development.
capacitor-vue	Vue-specific patterns and best practices for Capacitor app development.

Capawesome

Skill	Description
capawesome-cli	Install, configure, and use the Capawesome CLI for authentication, project linking, and CI/CD integration.
capawesome-cloud	Set up and manage native builds, live updates, and app store publishing for Capacitor and Cordova apps using Capawesome Cloud.
capawesome-mcp	Connect an MCP client to the hosted Capawesome MCP Server for always-current documentation and Capawesome Cloud management.

Capgo

Skill	Description
capgo-cloud-migration	Migrate from Capgo to Capawesome Cloud.

Ionic

Skill	Description
ionic-angular	Angular-specific Ionic development patterns — navigation, lifecycle hooks, forms, and standalone vs NgModule architecture.
ionic-app-creation	Create a new Ionic app with framework integration, Capacitor setup, and Tailwind CSS.
ionic-app-development	General Ionic Framework development — core concepts, component reference, CLI usage, layout, theming, and troubleshooting.
ionic-app-upgrades	Upgrade an Ionic app to a newer major version (4 through 8).
ionic-expert	Comprehensive Ionic Framework expert skill — core concepts, components, theming, lifecycle, navigation, and framework-specific patterns.
ionic-react	React-specific Ionic development patterns — components, IonReactRouter, lifecycle hooks, and state management.
ionic-vue	Vue-specific Ionic development patterns — components, navigation, lifecycle hooks, and composables.

Ionic Appflow

Skill	Description
ionic-appflow-migration	Migrate from Ionic Appflow to Capawesome Cloud.
ionic-enterprise-sdk-migration	Migrate from discontinued Ionic Enterprise SDK plugins to Capawesome alternatives.

License

See LICENSE.