Skip to main content

AI Agent Skills

If you use an AI coding agent such as Claude Code, Cursor, GitHub Copilot, or Windsurf, you can install an AppTrove SDK skill into your project and let the agent handle the integration: SDK setup, initialization, event tracking, attribution, and deep-link configuration.

Install​

Run this in your app's repository:

npx apptrove-sdk-skills list       # see supported platforms and current SDK versions
npx apptrove-sdk-skills add android

The installer detects which AI agent(s) and project platform are in the current folder, and installs the skill into every detected agent automatically.

Then, in your agent's chat, ask:

Integrate the AppTrove SDK into this project.

Or, for a narrower task:

Set up AppTrove events code.

Supported platforms​

PlatformCommand
Android (native)npx apptrove-sdk-skills add android
iOS (native)npx apptrove-sdk-skills add ios
Flutternpx apptrove-sdk-skills add flutter
React Nativenpx apptrove-sdk-skills add react-native
Exponpx apptrove-sdk-skills add expo
Cordovanpx apptrove-sdk-skills add cordova
.NET MAUInpx apptrove-sdk-skills add maui
Unitynpx apptrove-sdk-skills add unity
note

AppTrove's v2 SDK doesn't support Unity yet, so add unity installs a Trackier SDK skill instead of an AppTrove one. Every other platform installs the AppTrove v2 skill. Run list any time to see the exact SDK version each platform currently installs.

Two ways to integrate​

Ask your AI agent — it reads the installed SKILL.md and its references/, then writes the init code, deep-link config, and attribution/event setup for your specific project:

npx apptrove-sdk-skills add android

Then, in the agent's chat, ask it to integrate the SDK, as above.

Or add --integrate to have the installer make some of the changes itself, without the agent:

npx apptrove-sdk-skills add android --integrate --sdk-key YOUR_APP_TOKEN

How much --integrate automates is different on Android than on every other platform — verified against real projects for this doc:

PlatformWhat --integrate does automatically
AndroidEverything: adds the SDK dependency, manifest permissions, writes the SDK init code into your Application class, and adds the deep-link intent-filter
iOS, Flutter, React Native, Expo, Cordova, MAUIOnly adds the SDK dependency (Podfile / pubspec.yaml / package.json / …). It then prints the exact remaining steps — init code, imports, permissions, deep-link / Associated Domains config — to apply yourself or hand to your AI agent

On every platform except Android, asking your AI agent to finish the integration (using the skill that was just installed) is faster than copying those printed steps in by hand.

FlagWhat it does
--sdk-key <token>Your AppTrove app token / SDK key, filled in directly instead of a placeholder
--sdk-secret-id / --sdk-secret-keyOptional SDK signing secret, if your app uses one
--env <env>development (default) or production
--deep-link-host <host>Your UniLink subdomain, e.g. yourbrand.u9ilnk.me
--dry-runPreview what would change, without writing any files
--cwd <path>Run against a project in another directory
important

--integrate writes real changes to your project (at minimum, your dependency file; on Android, also the manifest and Application class). Run with --dry-run first if you want to preview, and review the diff before committing either way.

What a skill covers​

Whichever path you use, each platform skill is built to help with:

  • SDK dependency — the right package for the platform
  • Initialization — SDK init code with your app token
  • Deep links — intent-filter / Associated Domains setup, and deferred deep linking
  • Attribution — install attribution parameters
  • Events & user data — supported in-app events and user identification
  • Validation — checks (e.g. manifest, Gradle, deep-link config) bundled with the skill that the agent can run to confirm the integration

Find your AI agent​

Run npx apptrove-sdk-skills detect to see which agent(s) and project platform it found in the current folder. If more than one agent is detected, the skill is installed into all of them.

AgentSkill installed at
Claude Code.claude/skills/apptrove/<platform>/
Cursor.cursor/skills/apptrove-<platform>/
GitHub Copilot.github/skills/apptrove-<platform>/
Windsurf.windsurf/skills/apptrove-<platform>/
AGENTS.md-compatible agents.agents/skills/apptrove-<platform>/, with a short pointer to it added to AGENTS.md

What gets installed​

Each platform skill is a small folder:

  • SKILL.md — the instructions that guide the agent
  • references/ — platform-specific integration docs (deep links, events, user data, …)
  • templates/ — example config and code snippets
  • validators/ — scripts that check the integration

Before you start​

Have these ready before asking your agent to integrate:

  • Your AppTrove app token / SDK key
  • Application package name or bundle identifier
  • Your UniLink deep-link subdomain
  • Any event-tracking or user-identification requirements
warning

Never commit a real SDK key or secret to a public repository, or hardcode it outside your app's normal configuration.

Troubleshooting​

IssueFix
Agent doesn't use the installed skillConfirm the skill folder exists (see table above), then reopen or restart the agent and ask again
npx apptrove-sdk-skills fails to runCheck Node.js and npm are installed, and try npx apptrove-sdk-skills@latest add <platform>
Build fails after SDK integrationAsk your agent to check the error against the installed skill's references/ docs
Deep links don't open the appAsk your agent: "Review the AppTrove deep-link integration in this project. Check the existing configuration, identify any missing setup, and suggest or apply the necessary fixes."

Important​

AI Agent Skills help your coding agent make the SDK changes in your app. They don't create your AppTrove dashboard project, generate credentials for you, or replace end-to-end testing. Confirm the SDK version, permissions, attribution, event tracking, and deep-link behavior before you release.