Blog
Swell skills for AI coding agents
Build custom Swell apps from your terminal, with your AI coding agent doing the work alongside you.
The Swell custom app skill gives your AI coding agent everything it needs to build, validate, and ship Swell Apps without leaving your editor. Install it once with a single command, open a Swell app directory, and your agent picks up the full context: data model conventions, admin UI patterns, notification scaffolding, and serverless function structure.
This is the first piece of a broader effort to make Swell AI-native at the development layer. Today's release covers custom app development. More skills are in active work.
Install
The skill installs through the agent skills protocol, which works across Claude Code, Codex, and other supported agents:
npx skills add swellstores/skillsIf you're using Claude Code, you can also install it as a native plugin. This adds automatic updates:
/plugin marketplace add swellstores/skills
/plugin install swell-app@swellYou'll need Swell CLI installed and authenticated:
npm install -g @swell/cli
swell loginWhat the skill gives your agent
The skill ships guided workflows for the areas that come up most often in custom app development:
Data modeling. Define and evolve content models with the right field types, relationships, and validation. The skill knows the JSON schema definitions that the Swell CLI uses internally, so the models your agent writes will validate against the same rules the platform enforces at runtime.
Admin UI design. Build admin interfaces that match Swell's design patterns and component conventions. Your agent has the context to make sensible default choices about layout, form structure, and navigation rather than inventing its own.
Notifications. Scaffold notification handlers and templates with the correct event bindings and delivery configuration.
Serverless functions. Generate function boilerplate with the right entry points, environment access, and CLI deployment commands.
Why this matters for AI-native development
Most AI coding agents do well on greenfield code and struggle on platform-specific work. The reason is context: an agent that doesn't know your platform's conventions will either invent its own, which breaks at runtime, or ask you to spell out every constraint, which defeats the point of using an agent.
Skills solve this by packaging platform context as an installable, versioned, self-updating dependency. The skill knows what a Swell app looks like, what validates, what doesn't, and which CLI commands to reach for. Your agent inherits all of that the moment you install.
The skill is built on the same JSON schema definitions that power Swell CLI validation, which means there's a single source of truth across the platform: what the CLI accepts, what the schema validates, and what the agent generates all stay in sync automatically.
Open source
The skill is open source: https://github.com/swellstores/skills
If you want to contribute a workflow, file an issue, or extend the skill for your own custom app type, the repo is the place.
What's next
The custom app skill is the first in a planned set of skills covering more of the Swell development surface. We'll write about each as it ships.
Install the skill, point your AI agent at a Swell app directory, and let us know how it goes.