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 | | SDK code audit | npx @linkrunner/skills add code-audit | Reviews an existing Linkrunner integration from source on any stack and reports each defect with file:line evidence and a 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