# AI agent skills

> Install bundled restart_app skills for AI coding agents, covering Flutter app restarts, platform behavior, and iOS engine setup.

`restart_app` includes two AI agent skills: instructions and examples that help your coding agent integrate the package. The skills come from the package version installed in your project.

| Skill | Covers |
| --- | --- |
| `restart-app-integration` | Restart calls, modes, results, saved data, web routes, desktop apps, and background isolates. |
| `restart-app-ios-engine-restart` | AppDelegate and UIScene setup, plugin registration, custom Flutter engines, and iOS errors. |

## Install

From your Flutter project, run:

```sh
flutter pub get
dart run skills@ get restart_app
```

Select the skills when prompted. To install both:

```sh
dart run skills@ get restart_app --all
```

The CLI detects supported coding agents and installs the instructions in their configuration directories. For a generic Agent Skills directory, use:

```sh
dart run skills@ get restart_app --all --agent generic
```

This installs the files under `.agents/skills/`. The iOS skill includes `references/host-setup.md`; keep it with the skill if you copy the files manually.

## Requirements

Skills are included in `restart_app` 1.9.2 and later. The `dart run skills@` command requires Dart 3.12 or later.

With Dart 3.10 or 3.11, use the globally installed CLI:

```sh
dart pub global activate skills
dart pub global run skills get restart_app
```

Installing skills does not add a runtime dependency or change your app's minimum Dart or Flutter version. The instructions guide your agent; they do not run inside your app.

## Updates

After upgrading `restart_app`, run `flutter pub get` and install the skills again. The CLI detects changes and updates the instructions to match the resolved package.

If no skills appear, check that `restart_app` is a direct dependency at version 1.9.2 or later. Local path dependencies are supported too.

For CLI options and the packaging format, see Dart's [package skills guide](https://dart.dev/tools/pub/package-skills).