Superwall Skill

Give AI coding agents up-to-date Superwall docs, authenticated API access, and hands-on control of the paywall editor using the Superwall Skills.

The Superwall Skills are a set of Agent Skills that give AI coding agents everything they need to work with Superwall: live documentation, authenticated access to your account through the Superwall CLI, guided SDK integration flows for every platform, and hands-on control of the paywall editor.

This is different from Superwall Agents, which is the Superwall AI workspace for chats, analysis, automations, webhooks, and hosted machine work. The Superwall Skill is for giving AI coding agents Superwall docs, API access, and SDK guidance. The Skill can perform all of the tasks the Superwall MCP can, and is recommended when you are working in an external coding agent.

Installation

Install with one command:

npx superwall skills

The CLI shows a picker with every skill pre-selected. Press Enter and the skills install globally for every coding agent detected on your machine: Claude Code, Cursor, Codex, Gemini CLI, Copilot, Windsurf, and 70+ more. Run the same command again any time to update; it checks whether your installed skills are out of date first.

To install specific skills, or force a reinstall:

npx superwall skills --skill superwall     # just one skill
npx superwall skills --force               # reinstall even if up to date

If you use the Superwall CLI, you don't need to run this at all: superwall login installs the skills automatically and keeps them updated.

You can also install straight from the repo with the skills.sh CLI, which is what superwall skills uses under the hood: npx skills add superwall/skills.

What's included

Three skills, each covering a different job:

SkillWhat it does
superwallThe Superwall expert: docs, account resources, analytics, App Store Connect, and SDK workflows
superwall-editorHands-on control of the paywall editor session open in your browser
wwdcWWDC session lookup, comparison, transcripts, and timestamped citations

superwall

The general-purpose skill teaches your agent to work through the Superwall CLI, so everything runs against your real account:

  • Live documentation: fetched on demand from llms.txt and per-page markdown endpoints, so the agent always works from today's docs instead of training-data memory.
  • Account resources: projects, apps, products, entitlements, campaigns, and paywalls, listed and created via the CLI.
  • SQL analytics: ad hoc queries over your organization's ClickHouse analytics data with superwall query.
  • App Store Connect workflows: the full ASC API through Superwall's signed proxy, with schema lookup and local validation.
  • SDK integration: step-by-step integration flows for iOS, Android, Flutter, and Expo.
  • Migration and review: guided migration off RevenueCat, Adapty, or Qonversion, and integration audits before you ship.
  • Dashboard links: URL patterns for every dashboard page, so the agent can link you to the right place.
  • SDK source cloning: the agent can clone SDK repos locally to trace internal behavior when debugging.

superwall-editor

Attaches your agent to the paywall editor session open in your browser, using a pairing code. Once attached, the agent can build and restyle paywalls from a prompt, and edit onboarding and web2app flows live, while you watch the changes land in the editor.

To pair: open AI Chat in the paywall editor, expand the agent connection panel, choose Skill, and paste the pairing prompt into your agent. See Editor MCP for the full flow.

wwdc

WWDC on tap: find and compare WWDC sessions, navigate full session transcripts, cite sessions with timestamps, and summarize what changed platform to platform. Powered by wwdc.ai.

Authentication

The superwall skill authenticates through the official CLI, so resource and data commands run against your real account:

npm install --global superwall
superwall login

The session lives in ~/.superwall and every command shares it. In CI, authenticate with an API key instead of a browser: superwall login --api-key <key>. See the Superwall CLI guide for the full command reference.

Quick start

Ask your AI agent to integrate Superwall into your app. The agent will:

  1. Detect your platform from the project structure (e.g., Package.swift → iOS, pubspec.yaml → Flutter).
  2. Determine your purchase controller path, whether you're using Superwall's default purchase handling, RevenueCat, or a custom setup.
  3. Walk through the integration steps, implementing each one in your codebase.

Want the fully automated version? npx superwall integrate signs you up and integrates the SDK in one shot, driven by the Claude Code or Codex on your machine. See Set up your app in the CLI guide.

  • Superwall CLI: The command line tool the superwall skill drives.
  • Superwall Agents: For experiment analysis with connected Superwall tooling, automations, webhooks, and hosted machines.
  • Superwall MCP: For managing your Superwall account from AI tools.
  • Editor MCP: For connecting external agents to the paywall currently open in the editor.
  • AI Chat Builder: For using Superwall's built-in editor chat to build and refine paywalls.
  • Vibe Coding: All the AI tools available for working with Superwall listed in one place.

How is this guide?

On this page