Skills catalogue

An overview of the skills included in the boilerplate, and how to use them with your coding agent.

A skill is a set of instructions your agent loads when it recognises the task. They are part of the repository, so you get them with the clone and there is nothing to install. They are also updated with the code they describe, so they never fall out of date with your project.

Setting up

Skill	What it does
`setup`	Configures a fresh clone end to end: app identity in `config.js`, the Supabase project, the schema and edge functions, the OpenRouter key behind chat, then the optional RevenueCat, Superwall, OneSignal, Sentry, PostHog and sign-in integrations. It verifies each one before moving on, and can resume an interrupted run.

Start it with:


yarn skills:doctor

Writing code

You will use these three every time you build a screen.

Skill	What it does
`conventions`	Says where a new file, hook, component or integration belongs, and the rules for comments, imports, theme tokens, data fetching, i18n, tablet layout, fonts, testIDs and TypeScript.
`uniwind`	Styling with Uniwind, which is Tailwind v4 for React Native. Covers `className` props, `accent-*` colour props, theming through CSS variables, platform and state variants, and `withUniwind` for third-party components.
`heroui-native`	Building UI with HeroUI Native: Buttons, Cards, TextFields and Dialogs, and theming them light and dark.

Shipping

Skill	What it does
`store-assets`	Captures screens on a simulator with a frozen status bar, renders them at exact store dimensions against device mockups, and validates every file against Apple’s and Google’s specs before upload.
`submit`	The EAS build and submit pipeline, TestFlight, version bumps and release checklists.

These two build, upload and submit. Both are set to run only when you ask for them by name, never on their own.

Using them with your agent

Every agent looks for skills in its own folder. The boilerplate contains both of the common ones, so these agents pick the skills up with no setup from you:

Agent	Looks in
Claude Code	`.claude/skills/`
Cursor, Codex, GitHub Copilot, Gemini CLI, Cline, OpenCode	`.agents/skills/`

Using something else, such as Windsurf or Continue? This copies the skills into whatever folder your agent uses:


yarn skills:install

The starter skill

One skill sits outside the repository, because it runs before you have a repository. It creates the app, then hands over to the setup skill inside it.


npx skills add robinfaraj/nativeexpress-skills -g --copy -y

-g installs it for every coding agent on your machine. Drop it to install into the current folder only.

Leave --copy in the command. Without it the installer creates shortcuts to the files rather than the files themselves, and most Windows setups cannot follow those, so your agent finds no skills at all.

You do not have to install it. The alternative is to create the app yourself with npx nativeexpress@latest create-app my-app, then open the result in your agent. The skills come with the clone either way, so everything from that point on is the same. The manual setup walkthrough starts there.

Checking your setup


yarn skills:doctor

Run it any time, from anywhere in the project. It reports:

each integration as on, partial or off
any value left at the boilerplate default
whether your deployed edge-function secrets match config.js