# Agent skills

The Faustine agent skills are instructions for the coding agent you already use, such as Claude Code, Cursor or Codex. Your coding agent reads a skill and edits your repository while you review. Nothing runs on Faustine's side.

| | |
| --- | --- |
| Skills | `install-faustine`, `enable-faustine-adapter`, `sync-faustine-adapter` |
| License | MIT |
| Source | [faustine-ai/skills](https://github.com/faustine-ai/skills) |

## Install

Run this in the directory of your app. It adds the three skills for every coding agent you use.

```bash
npx skills add faustine-ai/skills
```

To add one skill only:

```bash
npx skills add faustine-ai/skills --skill install-faustine
```

Each skill is a folder with a `SKILL.md` file. Without the `skills` CLI, copy the folder from the repository into your coding agent's skills directory. For Claude Code that is `.claude/skills/`.

## install-faustine

Installs a Web Agent in a Next.js app, with the App Router or the Pages Router, or in a client-rendered single-page app built with React, Vue, Angular or Svelte.

```text
/install-faustine <AGENT_ID> [--setup <SETUP_CODE>] [--env <NAME>] [--debug]
```

The **Install the assistant** card on the agent's **Overview** tab writes this line with your ID. The skill reads the repository to find the framework, the entry point and where the session comes from. It then installs the package, mounts the agent once, signs the identity on your server when the app has a session, and checks the launcher in the browser.

| Argument | Effect |
| --- | --- |
| `--setup <SETUP_CODE>` | Also installs the Next.js adapter, by handing over to `enable-faustine-adapter`. |
| `--env <NAME>` | Loads that environment of the agent. The default is Production. |
| `--debug` | Opens a debug session from the page, for development and staging installs. |

If the agent is already installed, the skill reports where it is mounted and changes only what you asked for. It does not add `FAUSTINE_IDENTITY_SECRET` to the repository. It asks you to set the variable in your environment.

## enable-faustine-adapter

Adds [the Faustine adapter for Next.js](https://docs.faustine.ai/web-agents/nextjs-adapter/) to an App Router app, so that the agent can call Server Actions and server-only data functions.

```text
/enable-faustine-adapter --setup <SETUP_CODE> [--operations a.b,c.d]
```

The skill runs `npx faustine-next init --setup <SETUP_CODE> --dry-run` and shows you the operations Faustine found. It asks which ones stay private and where the user's identity comes from, then writes the registry and the route handler, mounts the agent if the app does not have it, and verifies the result with the app's build and `npx faustine-next doctor`.

On a Pages Router app the skill stops and says that the adapter needs the App Router.

## sync-faustine-adapter

Updates the adapter's registry after Server Actions or data functions were added, renamed or removed.

```text
/sync-faustine-adapter [--check] [--operations a.b,c.d]
```

The skill runs `npx faustine-next sync --dry-run`, shows the new operations and the ones left out, and asks for a decision on each new one before it runs `sync`. It keeps out the lines you removed from the registry. See [Keep the adapter in sync](https://docs.faustine.ai/web-agents/sync-the-adapter/).

## What the skills do not do

- They do not put a function in the registry that you did not see in the dry-run list.
- They do not edit operation names in the registry.
- They do not commit or print the identity secret, a setup code or an adapter token.
- With no one to answer their questions, they stop and report what they need.

## Next steps

- [Set up with a coding agent](https://docs.faustine.ai/get-started/set-up-with-a-coding-agent/): the whole setup driven from your coding agent.
- [Install in Next.js](https://docs.faustine.ai/web-agents/install-in-nextjs/): the same install, by hand.
- [faustine-next CLI](https://docs.faustine.ai/reference/faustine-next-cli/): the generator the adapter skills run.