Intercom Local Dev Loop

What it does

When your agent uses it

• Setting up a development environment
• Writing tests against the Intercom API
• Establishing a fast iteration cycle against a dev workspace
• With phrases like intercom dev setup

Example prompts

• “intercom dev setup”
• “intercom local development”
• “intercom dev environment”
• “/intercom-local-dev-loop”

Requirements

• Node.js
• A credential in INTERCOM_ACCESS_TOKEN
• Compatibility (from SKILL.md): Designed for Claude Code
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(npm:*), Bash(npx:*)

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Scaffold the project structure — an src/intercom/ module (singleton
2. 2Configure environments — commit .env.example as the template and keep
3. 3Write an environment-aware client singleton that reads the token, throws a
4. 4Build a mock client factory (tests/mocks/intercom.ts) covering contacts,
5. 5Write mocked unit tests against the factory, asserting call arguments and
6. 6Tunnel webhooks with ngrok — run the local server, ngrok http 3000, and
7. 7Wire package scripts (dev, test, test:watch, test:integration,

What it can do on your machine

Read from SKILL.md and the folder at commit 23ea8d4. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash(npm:*)
  • Bash(npx:*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm
  • ngrok

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • npmjs.com
  • vitest.dev
  • ngrok.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • INTERCOM_ACCESS_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code

  From compatibility in the SKILL.md frontmatter.

Context cost

Intercom Local Dev Loop loads about 1.5k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 530 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~102

When it runs · the whole SKILL.md, loaded when a task matches

~1.5k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:40

  _ACCESS_TOKEN` (loaded from git-ignored `.env.development`);

• NoteMentions a .env fileSKILL.md:42

  kspace is only a matter of swapping the `.env.development`

• NoteMentions a .env fileSKILL.md:53

  `.env.development` and `.env.test` git-ignored). Use **Write** to create each

• NoteMentions a .env fileSKILL.md:57

  real tokens in the git-ignored `.env.development`. See

• NoteMentions a .env fileSKILL.md:75

  CESS_TOKEN not set. Copy .env.example to .env.development"

• NoteMentions a .env fileSKILL.md:111

  `.env.development` / `.env.test`.

• NoteMentions a .env fileSKILL.md:122

  INTERCOM_ACCESS_TOKEN not set` | Missing .env file | Copy `.env.example` to `.env.development` |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 23ea8d4, republished under its MIT licence (© jeremylongshore). 530 words, ~1,544 tokens.

name

intercom-local-dev-loop

description

Configure Intercom local development with testing, mocking, and hot reload. Use when setting up a development environment, writing tests against the Intercom API, or establishing a fast iteration cycle against a dev workspace. Trigger with phrases like "intercom dev setup", "intercom local development", "intercom dev environment", "develop with intercom", "test intercom locally".

allowed-tools

Read, Write, Edit, Bash(npm:*), Bash(npx:*)

compatibility

Designed for Claude Code

version

1.6.0

license

MIT

author

Jeremy Longshore <jeremy@intentsolutions.io>

tags

saas, support, messaging, intercom

it("should create a user contact", async () => {
  const contact = await mockClient.contacts.create({
    role: "user",
    externalId: "user-123",
    email: "test@example.com",
  });

  expect(contact.id).toBe("mock-contact-id");
  expect(mockClient.contacts.create).toHaveBeenCalledOnce();
});

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/.curated/intercom-local-dev-loop of jeremylongshore/tons-of-skills-marketplace.

• SKILL.md
• references/examples.md
• references/implementation.md

Open the folder on GitHubat commit 23ea8d4