Linkrunner Agent Skills

Installable Agent Skills that teach your AI coding agent how to integrate the Linkrunner attribution SDK and set up deep linking - correctly, and with self-verifying checks - instead of following the docs by hand.

Published on npm as @linkrunner/skills.

Works with Claude Code, Cursor, Windsurf, GitHub Copilot, or any agent that reads AGENTS.md.

Quick start

# in your app's repo
npx @linkrunner/skills list
npx @linkrunner/skills add flutter

The installer detects which agent your repo is set up for and writes the skill in that agent's native format. Then ask your agent: "integrate Linkrunner" or "set up Linkrunner deep links" and it will pick up the skill.

Force a specific target, or install for several at once:

npx @linkrunner/skills add ios --agent cursor
npx @linkrunner/skills add react-native --dir ./apps/mobile
npx @linkrunner/skills add flutter --dry-run   # preview, write nothing

Supported platforms

Platform	Skill id	Package
Flutter	linkrunner-flutter	linkrunner
React Native	linkrunner-react-native	rn-linkrunner
Expo	linkrunner-expo	expo-linkrunner
iOS (native)	linkrunner-ios	linkrunner-ios
Android (native)	linkrunner-android	io.linkrunner:android-sdk
Capacitor	linkrunner-capacitor	capacitor-linkrunner
Cordova	linkrunner-cordova	cordova-linkrunner
Unity	linkrunner-unity	native bridge (Android + iOS SDKs)

Beyond SDK integration

Cross-cutting skills that are not tied to one platform:

Skill	Install	What it does
Deep link troubleshooter	npx @linkrunner/skills add deep-links	Diagnoses why Universal Links / App Links open the browser instead of the app and reports the exact fix
Event & revenue instrumentation	npx @linkrunner/skills add events	Correct event taxonomy + revenue (dedupe / refunds) + server-side event/revenue APIs
Webhooks receiver	npx @linkrunner/skills add webhooks	Writes a webhook endpoint in your backend that verifies the linkrunner-key header and handles install/signup payloads

Run npx @linkrunner/skills list to see everything grouped by category.

What each skill contains

skills/sdk/<platform>/
  SKILL.md                 # trigger + decision tree + golden rules (the entry point)
  references/
    install.md             # add package + native config + init
    deep-linking.md        # Universal Links / App Links / custom schemes + debugging
    events.md              # identify, events, revenue, attribution
  scripts/
    verify-deeplinks.sh    # checks hosted AASA/assetlinks + native wiring

Skills are authored to inspect the project before editing and verify after - the deep-link validator is what turns "I pasted the config" into "the link actually opens the app".

How agent targets are written

Agent	Written to
Claude Code	.claude/skills/<id>/ (SKILL.md + references + scripts, verbatim)
Cursor	.cursor/rules/<id>.mdc
Windsurf	.windsurf/rules/<id>.md
Copilot	.github/instructions/<id>.instructions.md
Generic	AGENTS.md (idempotent section)

Single-file targets get the references inlined and the validator scripts dropped under .linkrunner/<id>/scripts/.

Contributing / adding a platform

See AUTHORING.md. The canonical content lives here; keep it in sync with docs.linkrunner.io.

License

MIT