Capacitor Agent Skills by Capgo

➡️ Get Instant updates for your App with Capgo

Formerly @capgo/capacitor-skills (and Cap-go/capacitor-skills). Links and redirects should continue to work.

Agent skills for building, shipping, and maintaining Capacitor apps with AI coding agents (Claude Code, Codex, Cursor, Copilot, Gemini CLI). Skills are packaged instructions that extend agent capabilities for mobile development.

These skills are maintained by Capgo, the AI-ready platform to build, ship, and maintain Capacitor apps: Capacitor skills and MCP servers for AI coding agents, maintained Capacitor plugins, cloud native iOS/Android builds with App Store and Google Play publishing, live updates with channels and rollback, and release monitoring.

Build Capacitor apps with AI, ship updates instantly. Browse the catalog at capgo.app/skills and the agent setup guide at capgo.app/agents.

Lifecycle Coverage

Use with AI Coding Agents

1. Install the skills (see Installation for Claude Code, Codex, Cursor, and Gemini CLI plugin options):

   npx skills add Cap-go/capgo-skills
   

2. Connect the Capgo MCP server so the agent can manage apps, channels, bundles, and builds:

   • Hosted MCP: https://api.capgo.app/mcp (docs)
   • Local MCP: npx @capgo/cli@latest mcp

See capgo.app/agents for per-agent setup and capgo.app/best/ai-tools-for-capacitor for an overview of AI tooling for Capacitor.

Compatibility

Note: The major version of this plugin follows the major version of Capacitor. Use the version that matches your Capacitor installation (e.g., plugin v8 for Capacitor 8). Only the latest major version is actively maintained.

Installation

skills.sh

npx skills add Cap-go/capgo-skills

Claude Code Plugin Marketplace

Claude Code users can add this repository as a plugin marketplace and install focused plugin groups:

claude plugin marketplace add Cap-go/capgo-skills

Available plugins:

Install a plugin:

claude plugin install capgo-cloud@capgo-skills

Gemini CLI

gemini extensions install https://github.com/Cap-go/capgo-skills

Cursor and Codex

The same plugin groups are published for Cursor (.cursor-plugin/marketplace.json) and Codex (.agents/plugins/marketplace.json). Add this repository as a plugin marketplace in either tool, then install the plugin groups you need.

Available Skills

Core Development

Growth & Revenue

Security

Testing & CI/CD

Debugging & Tooling

UI & Design

Features

Performance & Accessibility

Deployment

Operations

Authoring

Upgrades

Migration

Usage

Skills activate automatically when agents detect relevant tasks:

Security

• "Run a security scan" → capacitor-security (Capsec)
• "Check for vulnerabilities" → capacitor-security

Testing & CI/CD

• "Add unit tests" → capacitor-testing
• "Set up GitHub Actions" → capacitor-ci-cd

Capgo Cloud

• "How do I use the Capgo CLI?" → capgo-cli-usage
• "Set up Capgo cloud workflows" → capgo-cloud
• "Request a native build" → capgo-native-builds
• "Upload a bundle to a channel" → capgo-release-management
• "Manage Capgo organization members" → capgo-organization-management

Growth & Revenue

• "How do I make revenue from my app?" → subscription-app-revenue
• "Help me get to $1K MRR" → subscription-app-revenue
• "Plan my app paywall and pricing" → subscription-app-revenue
• "Get first users for my subscription app" → subscription-app-revenue

Features

• "Add push notifications" → capacitor-push-notifications
• "Implement deep linking" → capacitor-deep-linking
• "Make app work offline" → capacitor-offline-first

Deployment

• "Run a Capgo build" → capgo-native-builds
• "Manage Capgo channels" → capgo-release-management
• "Set up the full release workflow" → capgo-release-workflows
• "Publish to App Store" → capacitor-app-store
• "Run an Apple review preflight" → capacitor-apple-review-preflight
• "Help me fix an App Store rejection for my Capacitor app" → capacitor-apple-review-preflight
• "Submit to Play Store" → capacitor-app-store
• "Add SPM support to a plugin" → capacitor-plugin-spm-support
• "Migrate my Capacitor app to Swift Package Manager" → cocoapods-to-spm

Authoring

• "Create a new skill" → skill-creator
• "Validate a skill" → skill-creator

Upgrades

• "Upgrade a Capacitor app" → capacitor-app-upgrades
• "Upgrade a Capacitor plugin" → capacitor-plugin-upgrades
• "Upgrade a Capacitor app from v4 to v5" → capacitor-app-upgrade-v4-to-v5
• "Upgrade a Capacitor app from v5 to v6" → capacitor-app-upgrade-v5-to-v6
• "Upgrade a Capacitor app from v6 to v7" → capacitor-app-upgrade-v6-to-v7
• "Upgrade a Capacitor app from v7 to v8" → capacitor-app-upgrade-v7-to-v8
• "Adopt UIScene / Xcode 27 build fails on lifecycle" → capacitor-uiscene-migration
• "Upgrade a Capacitor app to Capacitor 9" → capacitor-app-upgrade-v8-to-v9
• "Upgrade a Capacitor plugin from v4 to v5" → capacitor-plugin-upgrade-v4-to-v5
• "Upgrade a Capacitor plugin from v5 to v6" → capacitor-plugin-upgrade-v5-to-v6
• "Upgrade a Capacitor plugin from v6 to v7" → capacitor-plugin-upgrade-v6-to-v7
• "Upgrade a Capacitor plugin from v7 to v8" → capacitor-plugin-upgrade-v7-to-v8
• "Upgrade a Capacitor plugin to Capacitor 9" → capacitor-plugin-upgrade-v8-to-v9

Migration

• "Migrate from Cordova" → cordova-to-capacitor
• "Convert Next.js to mobile app" → framework-to-capacitor
• "Add Capacitor to React app" → framework-to-capacitor
• "Turn my web app into an app" → webapp-to-capacitor
• "Migrate from Ionic Appflow" → ionic-appflow-migration
• "Migrate from Capawesome live updates" → capawesome-live-update-migration
• "Migrate SQLite to Fast SQL" → sqlite-to-fast-sql
• "Remove Ionic Enterprise SDK" → ionic-enterprise-sdk-migration

UI/UX

• "Fix keyboard issues" → capacitor-keyboard
• "Configure splash screen" → capacitor-splash-screen
• "Make app accessible" → capacitor-accessibility

Quick Start with Capgo

1. Create Account

Go to https://capgo.app and sign up.

2. Install CLI

npm install -g @capgo/cli
npx @capgo/cli@latest login

3. Initialize & Deploy

npx @capgo/cli@latest init
npm run build
npx @capgo/cli@latest bundle upload

Security Scanning with Capsec

# Scan for vulnerabilities
npx @capgo/capgo-sec@latest scan

# CI mode (fails on high/critical)
npx @capgo/capgo-sec@latest scan --ci

# Generate HTML report
npx @capgo/capgo-sec@latest scan --output html --output-file security.html

Capsec detects 63+ security issues including:

• Hardcoded secrets and API keys
• Insecure storage patterns
• Network security issues
• Platform-specific vulnerabilities
• Authentication weaknesses

Learn more: https://capacitor-sec.dev

About Capgo

Capgo is the AI-ready platform to build, ship, and maintain Capacitor apps:

• AI agent tooling: These Capacitor skills plus hosted and local MCP servers for AI coding agents
• Plugins: Maintained Capacitor plugins for authentication, media, payments, sensors, and more
• Native Builds: Cloud iOS and Android builds with App Store and Google Play publishing
• Live Updates: Deploy JS/HTML/CSS instantly without app store review, with channels and rollback
• Release Monitoring: Track update adoption and release health
• Capsec: Security scanning for Capacitor apps

Resources

• Capgo: https://capgo.app
• Capgo skills catalog: https://capgo.app/skills/
• AI agent setup: https://capgo.app/agents/
• Capgo MCP docs: https://capgo.app/docs/ai/mcp/
• Capsec: https://capacitor-sec.dev
• Capacitor: https://capacitorjs.com
• Ionic: https://ionicframework.com
• Konsta UI: https://konstaui.com
• Discord: https://discord.gg/capgo

Contributing

Add new skills by creating a folder in skills/ with:

• SKILL.md - Instructions for agents
• metadata.json - Skill metadata

Expose the skill in a Claude Code plugin by creating an empty plugins/<plugin>/skills/<skill>/ folder, then copy the canonical files and validate:

bun run sync-skills
bun run lint-skills

Plugin copies must match skills/ byte-for-byte; lint fails on drift.

Run the skillgrade-backed eval for the skill authoring workflow with an API key:

ENABLE_SKILLGRADE=1 bun run lint-skills-skillgrade

License

MIT