AI Skills
Detour ships two AI skills for Claude Code. They give your AI agent up-to-date guidance for setting up or migrating to Detour. Both are open-source and maintained by Software Mansion in the software-mansion-labs/skills repository.
Installation
As a plugin (recommended)
/plugin marketplace add software-mansion-labs/skills
/plugin install skills@swmansion
/reload-plugins
Via npx
npx -y skills add software-mansion-labs/skills --agent claude-code
When prompted, select the skill you want to install:
detour-onboarding— for new Detour integrations from scratchmigrate-to-detour— for migrating from Branch or AppsFlyer
detour-onboarding
Guides developers through a full Detour setup from scratch. Use this if you're adding deep linking to your app for the first time.
Covers:
- Detour Dashboard setup (organization subdomain, App ID, API key)
- Universal Links and App Links configuration
- SDK integration for iOS, Android, React Native, and Flutter
- Analytics tracking with type-safe enums
migrate-to-detour
Migrates an existing Branch or AppsFlyer integration to Detour. Use this if you already have deep linking set up and want to switch.
Covers:
- Replacing the old domain (e.g.
yourapp.app.link,yourapp.onelink.me) with your Detour subdomain - SDK swap: moving from Branch/AppsFlyer callbacks to Detour's single
result.typecallback - Mapping analytics events from
af_purchase/BranchEvent.Purchaseto Detour equivalents - Flagging unsupported features with no Detour equivalent (in-app purchase validation, ATT/SKAdNetwork, SDK-side link generation)
The skill processes platforms in a fixed order: Android → iOS → React Native → Flutter.
Testing deferred links
Both skills guide you through the same testing flow. Deferred links must be tested on a real device — simulators don't work.
- Uninstall the app from the device.
- Open the Detour link (
https://ORG.godetour.link/APP_HASH/path) in a mobile browser. Don't use short links for first tests. - Install the build.
- Open the app and check the incoming
LinkResult.
Detour tracks unique device fingerprints. The same link won't trigger deferred resolution twice on the same device. Generate a fresh link in the dashboard for each test.