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
| Platform | Command |
|---|---|
| Android (native) | npx apptrove-sdk-skills add android |
| iOS (native) | npx apptrove-sdk-skills add ios |
| Flutter | npx apptrove-sdk-skills add flutter |
| React Native | npx apptrove-sdk-skills add react-native |
| Expo | npx apptrove-sdk-skills add expo |
| Cordova | npx apptrove-sdk-skills add cordova |
| .NET MAUI | npx apptrove-sdk-skills add maui |
| Unity | npx apptrove-sdk-skills add unity |
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:
| Platform | What --integrate does automatically |
|---|---|
| Android | Everything: 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, MAUI | Only 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.
| Flag | What it does |
|---|---|
--sdk-key <token> | Your AppTrove app token / SDK key, filled in directly instead of a placeholder |
--sdk-secret-id / --sdk-secret-key | Optional 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-run | Preview what would change, without writing any files |
--cwd <path> | Run against a project in another directory |
--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.
| Agent | Skill 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 agentreferences/— platform-specific integration docs (deep links, events, user data, …)templates/— example config and code snippetsvalidators/— 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
Never commit a real SDK key or secret to a public repository, or hardcode it outside your app's normal configuration.
Troubleshooting
| Issue | Fix |
|---|---|
| Agent doesn't use the installed skill | Confirm the skill folder exists (see table above), then reopen or restart the agent and ask again |
npx apptrove-sdk-skills fails to run | Check Node.js and npm are installed, and try npx apptrove-sdk-skills@latest add <platform> |
| Build fails after SDK integration | Ask your agent to check the error against the installed skill's references/ docs |
| Deep links don't open the app | Ask 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.
Related
- Apptrove CLI — check an existing integration's health from the terminal
- Android SDK · iOS SDK · Flutter SDK
- Support: support@apptrove.com