Linkrunner Agent Skills

Installable Agent Skills that teach your AI coding agent how to integrate the Linkrunner attribution SDK, troubleshoot attribution workflows, and design brand-consistent Linkrunner surfaces. Skills include self-verifying checks, current references, and canonical brand assets.

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
Linkrunner brand system	npx @linkrunner/skills add branding	Applies one Linkrunner identity across public marketing, customer product, internal tools, documents, reports, decks, social, and partner surfaces

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".

The branding skill also ships current SVG and PNG logo files, portable CSS and JSON tokens, surface-specific playbooks, a checksum manifest, and a brand review checklist.

How agent targets are written

Agent	Written to
Claude Code	.claude/skills/<id>/ (complete skill folder, including assets and templates)
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 Markdown references inlined. Supporting references, assets, templates, and scripts are also copied under .linkrunner/<id>/ so the installed skill remains complete.

Contributing / adding a platform

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

License

MIT