iterable-sdk-skill

A skill that turns your AI coding assistant (Cursor, Claude Code) into a reliable guide for integrating the Iterable Android SDK. It's derived from Iterable's official documentation, so the code your assistant writes matches how the SDK actually works — not the model's stale guess at it.

It also adds the one thing the docs don't have: hand-written pitfalls for the silent-failure traps that quietly break integrations (JWT keys with no auth handler, missing POST_NOTIFICATIONS on Android 13+, setEmail inside the init callback, and more).

Install

Claude Code — install the plugin from this repo's marketplace:

/plugin marketplace add Iterable/iterable-sdk-skill
/plugin install iterable-sdk@iterable

This installs the skill and wires up its documentation source in one step.

Cursor — install it as a plugin, which wires up the skill and its documentation source (the Context7 MCP server) in one step. Cursor 3.9+ supports Agent Skills and plugins natively.

Clone the repo and symlink it into Cursor's local-plugins folder, then restart Cursor (or reload the window):

git clone --depth 1 https://github.com/Iterable/iterable-sdk-skill.git ~/iterable-skills
ln -s ~/iterable-skills ~/.cursor/plugins/local/iterable-sdk

A Cursor team admin can instead publish it to the whole org via Dashboard → Plugins → Add Marketplace → Import from Repo, pointing at this repo.

Just the skill, no plugin? Cursor 3.9+ auto-loads Agent Skills from ~/.cursor/skills/ — symlink only the skill directory: ln -s ~/iterable-skills/iterable-android ~/.cursor/skills/iterable-android. This skips the doc source; to add it, paste this into your browser to install the Context7 MCP server:

cursor://anysphere.cursor-deeplink/mcp/install?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0=

Either way, the skill activates automatically whenever you mention Iterable: it loads its always-on rules and PITFALLS.md, then pulls the documentation for whatever feature you're working on (see How it works).

How it works

The skill carries a copy of the Iterable documentation inside it (iterable-android/snapshot/), so it always has the docs on hand — even offline. This snapshot is the active source today.

The plugin (both Claude Code and Cursor) also connects to Context7, a service that hosts docs for AI assistants to query on demand. That connection is bundled and ready, but stays dormant until Iterable's curated library is published there; once it is, the skill fetches the latest docs live, with the snapshot as its fallback. No reinstall needed when that happens.

Context7 works without an API key at a lower rate limit. To raise it, get a free key at context7.com and set the CONTEXT7_API_KEY environment variable — the bundled MCP config forwards it automatically.

What it covers

Push notifications, in-app messages, mobile inbox, embedded messaging, deep linking, JWT authentication, event tracking, user profiles, and unknown-user activation. Snippets are Kotlin-first and version-pinned to the SDK release each was validated against.

See iterable-android/SKILL.md for the full routing table.

Repo layout

iterable-android/   the installable skill (SKILL.md + PITFALLS.md + snapshot/)
polished/           the docs in agent-ready form (what gets published to Context7)
pipeline/           tooling that builds polished/ from sources/, CI-gated
sources/            raw Iterable docs, fetched at pinned commits
context7.json       Context7 manifest
.claude-plugin/     Claude Code plugin + marketplace manifests
.cursor-plugin/     Cursor plugin + marketplace manifests
mcp.json            Context7 MCP server (Cursor plugin auto-discovery)
.mcp.json           same config (Claude Code auto-discovery; kept in sync by CI)

Staying current

When Iterable's docs change, a workflow rebuilds the skill's content and opens a PR for a reviewer to check and merge — updates are never applied automatically. See REVIEW.md.

Limitations

• Android only. iOS, React Native, and Web are not yet covered.
• Some docs carry foreign snippets. A few articles come from shared "Mobile SDKs" pages and still contain iOS/JS code an Android agent must ignore.
• Context7 fetch is not live yet. The skill works today from its bundled snapshot; on-demand Context7 fetching turns on in an upcoming release.