# Detour Skills

Detour provides two AI skills that help your coding agent set up Detour or migrate to it.

Both use the open [Agent Skills](https://agentskills.io) format, so any agent that supports it can use them. They are open source and maintained by Software Mansion in the [software-mansion-labs/skills](https://github.com/software-mansion-labs/skills) repository.

## Available skills

[Detour onboarding](#detour-onboarding)
  [Migrate to Detour](#migrate-to-detour)
Both skills cover Android, iOS, React Native and Flutter.

## Installation

Run in Claude Code:

```text
/plugin marketplace add software-mansion-labs/skills
/plugin install skills@swmansion
/reload-plugins
```

To update, run `/plugin marketplace update swmansion`.

The [`skills` CLI](https://www.npmjs.com/package/skills) works with any
supported agent, Claude Code included:

```bash
npx skills add software-mansion-labs/skills
```

When prompted, select `detour-onboarding`, `migrate-to-detour`, or both.

The CLI installs the skills into every supported agent it finds. To choose the
agents, pass `--agent` once per agent, for example
`--agent claude-code --agent cursor`. To update, run `npx skills update`.

## Detour onboarding

**Skill name** — `detour-onboarding`

Use it when your app has no deep linking yet. The skill guides your agent through:

- Dashboard setup, including the organization subdomain, App ID and API key
- Universal Links and App Links configuration
- SDK integration for iOS, Android, React Native and Flutter
- Analytics tracking with type-safe enums

[View the skill source](https://github.com/software-mansion-labs/skills/tree/main/skills/detour/detour-onboarding)

## Migrate to Detour

**Skill name** — `migrate-to-detour`

Use it when your app already uses Branch or AppsFlyer. The skill guides your agent through:

- Replacing the old link domain, for example `yourapp.app.link` or `yourapp.onelink.me`, with your Detour subdomain
- Replacing the Branch or AppsFlyer callbacks with the single Detour `result.type` callback
- Mapping analytics events, for example `af_purchase` or `BranchEvent.Purchase`, to Detour events

It works through the platforms in this order: Android, iOS, React Native, Flutter.

:::caution[Some features have no Detour equivalent]
The skill flags in-app purchase validation, ATT and SKAdNetwork, and SDK-side
link generation. Plan a replacement for these before you migrate.
:::

[View the skill source](https://github.com/software-mansion-labs/skills/tree/main/skills/detour/migrate-to-detour)

## Testing

Both skills end with a deferred-link test on a real device. See
[Testing Deferred Links](https://detour.swmansion.com/docs/platform/fundamentals/testing).

## Related pages

[Getting Started with Detour](https://detour.swmansion.com/docs/platform/fundamentals/getting-started/)
  [Universal Links & App Links](https://detour.swmansion.com/docs/platform/fundamentals/universal-app-links/)
  [Analytics](https://detour.swmansion.com/docs/platform/fundamentals/analytics/)