Agent skill · software engineering · jeremylongshore
intercom-hello-world
Create a minimal working Intercom example with contacts, conversations,
Why this skill is useful
Provides specific commands and workflows for interacting with the Intercom API that the AI wouldn't reliably generate on its own.
What it needs
Requires intercom-client installed locally. Requires intercom account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Intercom Hello World Overview Minimal working examples covering the Intercom core data model: contacts (users and leads), conversations, messages, and tags. This skill gives you the first end-to-end round trip against the Intercom REST API — create a contact, search it, message it, open a conversation, and tag it — so you can confirm your credentials work and internalize how the entities relate before building anything real. Prerequisites Before running any snippet below, make sure the following are in place. Each is verified once during the intercom-install-auth setup step: Completed the intercom-install-auth setup (installs the SDK and stores your token). The intercom-client npm package installed in your project (npm install intercom-client). A valid Intercom access token exported as INTERCOMACCESSTOKEN in your environment. The SDK reads this token to authenticate every request; there is no separate login call. Instructions The workflow is five short steps against the core data model. The first — creating a contact — is shown in full here so you can run immediately. Steps 2 through 5 (search, message, conversation, tag) follow the identical client.<resource>.<verb>(...) shape and live in the walkthrough reference. Step 1: Create a Contact Contacts are the core entity. They have a role of either user (identified) or lead (anonymous). Remaining steps Continue in the full walkthrough, which covers, with complete code and response shapes: Step 2 — Search for Contacts (client.contacts.search) Step 3 — Send a Message (client.messages.create, admin → contact) Step 4 — Create a Conversation (client.conversations.create) Step 5 — Tag a Contact (client.tags.create + client.contacts.tag) The walkthrough also carries the full Core Data Model reference table (Contact, Conversation, Message, Tag, Company, Admin and their key fields). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-hello-world--085ba5