cap-go__capgo-skills/README.md

Capacitor Agent Skills

➡️ Get Instant updates for your App with Capgo

Missing a feature? We’ll build the plugin for you

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

A collection of 46 skills for AI coding agents working with Capacitor, the cross-platform native runtime. Skills are packaged instructions that extend agent capabilities for mobile development.

Compatibility

Plugin version	Capacitor compatibility	Maintained
v8.*.*	v8.*.*	✅
v7.*.*	v7.*.*	On demand
v6.*.*	v6.*.*	❌
v5.*.*	v5.*.*	❌

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

npx skills add Cap-go/capgo-skills

Available Skills

Core Development

Skill	Description
capgo-cli-usage	Route general Capgo CLI requests to the right workflow
capgo-cloud	Coordinate Capgo builds, releases, publishing, and organization workflows
capacitor-plugins	Official Capacitor packages plus Capgo plugin recommendations
capacitor-best-practices	Development best practices and patterns
capgo-live-updates	Deploy OTA updates instantly with Capgo

Security

Skill	Description
capacitor-security	Security scanning with Capsec (63+ rules)

Testing & CI/CD

Skill	Description
capacitor-testing	Unit, integration, and E2E testing
capacitor-ci-cd	GitHub Actions, GitLab CI, Fastlane

Debugging & Tooling

Skill	Description
debugging-capacitor	Debug iOS/Android apps
ios-android-logs	Device log streaming
capacitor-mcp	MCP automation tools

UI & Design

Skill	Description
ionic-design	Ionic Framework components
konsta-ui	Konsta UI for Tailwind
tailwind-capacitor	Tailwind CSS for mobile
safe-area-handling	Notch, Dynamic Island, home indicator
capacitor-splash-screen	Splash screen configuration

Features

Skill	Description
capacitor-push-notifications	FCM and APNs push notifications
capacitor-deep-linking	Universal links and app links
capacitor-offline-first	Offline-first architecture
capacitor-keyboard	Keyboard handling

Performance & Accessibility

Skill	Description
capacitor-performance	Performance optimization
capacitor-accessibility	Screen readers, WCAG compliance

Deployment

Skill	Description
capacitor-apple-review-preflight	Apple App Store review preflight for Capacitor apps
capgo-native-builds	Request hosted iOS and Android builds with Capgo Build
capgo-release-management	Manage bundles, channels, compatibility checks, and encryption
capgo-release-workflows	Coordinate Capgo live updates with builds and store publishing
capacitor-app-store	App Store and Play Store submission
capacitor-plugin-spm-support	Add Swift Package Manager support to a plugin
cocoapods-to-spm	Migrate to Swift Package Manager

Operations

Skill	Description
capgo-organization-management	Manage Capgo organizations, members, and security policies

Authoring

Skill	Description
skill-creator	Create and validate new skills with progressive disclosure

Upgrades

Skill	Description
capacitor-app-upgrades	Upgrade a Capacitor app across major versions
capacitor-app-upgrade-v4-to-v5	Upgrade a Capacitor app from v4 to v5
capacitor-app-upgrade-v5-to-v6	Upgrade a Capacitor app from v5 to v6
capacitor-app-upgrade-v6-to-v7	Upgrade a Capacitor app from v6 to v7
capacitor-app-upgrade-v7-to-v8	Upgrade a Capacitor app from v7 to v8
capacitor-plugin-upgrades	Upgrade a Capacitor plugin across major versions
capacitor-plugin-upgrade-v4-to-v5	Upgrade a Capacitor plugin from v4 to v5
capacitor-plugin-upgrade-v5-to-v6	Upgrade a Capacitor plugin from v5 to v6
capacitor-plugin-upgrade-v6-to-v7	Upgrade a Capacitor plugin from v6 to v7
capacitor-plugin-upgrade-v7-to-v8	Upgrade a Capacitor plugin from v7 to v8

Migration

Skill	Description
cordova-to-capacitor	Migrate from Cordova/PhoneGap to Capacitor
framework-to-capacitor	Integrate Next.js, React, Vue, Angular with Capacitor
ionic-appflow-migration	Migrate from Ionic Appflow to Capgo and repo-owned automation
sqlite-to-fast-sql	Migrate SQLite/SQL plugins to Fast SQL
ionic-enterprise-sdk-migration	Replace Ionic Enterprise SDK plugins with open alternatives

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

Features

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

Deployment

• "Run an Apple review preflight" → capacitor-apple-review-preflight
• "Why did Apple reject my app?" → capacitor-apple-review-preflight
• "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
• "Submit to Play Store" → capacitor-app-store
• "Add SPM support to a plugin" → capacitor-plugin-spm-support

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
• "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

Migration

• "Migrate from Cordova" → cordova-to-capacitor
• "Convert Next.js to mobile app" → framework-to-capacitor
• "Add Capacitor to React app" → framework-to-capacitor
• "Migrate from Ionic Appflow" → ionic-appflow-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 capsec scan

# CI mode (fails on high/critical)
npx capsec scan --ci

# Generate HTML report
npx capsec 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 provides:

• Live Updates: Deploy JS/HTML/CSS instantly without app store review
• 80+ Plugins: Native functionality for authentication, media, payments, sensors
• Capsec: Security scanning for Capacitor apps

Resources

• Capgo: https://capgo.app
• 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

Validate the pack locally with:

npm run lint-skills

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

ENABLE_SKILLGRADE=1 npm run lint-skills-skillgrade

License

MIT