Cordova
Installable Agent Skills for integrating the Linkrunner SDK and deep linking, for AI coding agents (Claude Code, Cursor, Windsurf, Copilot)
npx -y skills add linkrunner-labs/skills --skill cordovaAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 16 days oldThe repository was created 16 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Integrate the Linkrunner mobile attribution SDK into an Apache Cordova app - add the plugin, initialize it, identify users, track events and revenue, and set up deep linking (iOS Universal Links, Android App Links, and custom URI schemes) with domain verification. Use when someone asks to add Linkrunner to a Cordova app, wire up attribution, or debug why Linkrunner deep links are not opening the app.
SKILL.md
4.5 KB, 999 tokens by cl100k_base, as published. Nobody here has run it
Linkrunner - Cordova integration
You are integrating Linkrunner (mobile attribution + deep linking) into an Apache Cordova app. Work in this order and inspect the project before editing - do not paste snippets blindly.
0. Before you touch anything
- Confirm this is a Cordova app: there is a
config.xmlat the project root and awww/(or framework build output) folder. Checkplatforms/to see which platforms (android,ios) are already added. - Find where the app wires up
deviceready(oftenwww/js/index.jsor anapp.js), sincelinkrunner.init()must run there. - Ask the user for their project token (dashboard → Settings). If they use
SDK signing, also get
secretKey+keyId. Never hardcode these in a file that gets committed if the user keeps secrets elsewhere - ask where. - Check whether
config.xmlalready has the required preferences (below) before adding platforms or the plugin - order matters here.
1. Decide what the user actually needs
| They want... | Do this |
|---|---|
| "Add Linkrunner / set up attribution" | references/install.md then references/events.md (at minimum init + signup) |
| "Set up deep links" / "links open the browser not my app" | references/deep-linking.md + run scripts/verify-deeplinks.sh |
| "Track purchases / events" | references/events.md |
| "Set up uninstall tracking / push token" | references/events.md (Uninstall tracking / setPushToken) |
Most first-time integrations need install → init → signup → handle deeplink, in that order. Deep-link verification (AASA / assetlinks) is separate and is the part that usually breaks - treat it as its own step.
2. Requirements (verify, don't assume)
config.xmlpreferencesdeployment-target(15.0) andGradlePluginKotlinEnabled(+GradlePluginKotlinCodeStyle) must be set beforecordova platform add ios android. If platforms are already added,cordova platform remove ios androidthen re-add after editingconfig.xml.- iOS deployment target 15.0+ (comes from the
deployment-targetpreference). - Kotlin support enabled for Android (comes from
GradlePluginKotlinEnabled).
3. Golden rules
linkrunner.init()must run inside thedevicereadyevent handler, and only there - no import/require is needed,linkrunneris a global registered by the plugin.- Call
signup()the moment a user is identified (signup OR login) - this is what ties the install to a user.setUserData()is a later top-up, never a replacement. - For HTTP/HTTPS deep links, the app changes are worthless until the hosted
assetlinks.json(Android) andapple-app-site-association(iOS) verify. Always finish by runningscripts/verify-deeplinks.sh. - The Android SHA-256 fingerprint saved in Linkrunner must match the keystore that signed the build on the device. Debug and release differ.
- Cordova regenerates
platforms/androidandplatforms/iosoncordova prepare/cordova platform add. Native edits made directly insideplatforms/(manifest intent-filters, Xcode Associated Domains) get wiped - persist them throughconfig.xml(<config-file>/<edit-config>, see Apache Cordova's config.xml reference) or reapply them after every platform re-add.
4. Finish
After editing, run cordova prepare, build once per platform, and run
scripts/verify-deeplinks.sh <domain> <android_package> <ios_team_id.bundle_id>
to confirm deep-link verification is actually live. Report which checks passed
and which the user still has to do in the dashboard (host AASA/assetlinks under
Project Settings → Domain Verification).
References
references/install.md- config.xml prerequisites, plugin add, and initreferences/deep-linking.md- Universal Links / App Links / custom schemes + debuggingreferences/events.md- signup, setUserData, revenue, trackEvent, attribution