Skip to main content

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

/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 scratch
  • migrate-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

View skill source


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.type callback
  • Mapping analytics events from af_purchase / BranchEvent.Purchase to 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.

View skill source


Both skills guide you through the same testing flow. Deferred links must be tested on a real device — simulators don't work.

  1. Uninstall the app from the device.
  2. Open the Detour link (https://ORG.godetour.link/APP_HASH/path) in a mobile browser. Don't use short links for first tests.
  3. Install the build.
  4. Open the app and check the incoming LinkResult.
One link, one test

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.