Agent skill · software engineering · jeremylongshore
intercom-ci-integration
Configure CI/CD pipelines for Intercom integrations with GitHub Actions.
Why this skill is useful
Adds a complete CI/CD workflow for Intercom integrations with GitHub Actions, including specific testing and secret management patterns.
What it needs
Requires gh, npm 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 CI Integration Overview Set up CI/CD pipelines for Intercom integrations with GitHub Actions: unit tests with a mocked SDK (fast, token-free, run on every PR), integration tests against a dev workspace (gated to main pushes), webhook signature tests, and encrypted secret management. This SKILL.md carries the workflow at a high level; the full copy-ready workflow, secret setup, and complete test suites live in references/ for progressive disclosure. Prerequisites GitHub repository with Actions enabled Intercom dev workspace access token (separate from production) npm/pnpm project with intercom-client installed Authentication CI authenticates to Intercom with a dev workspace access token, never a production one. Store it as an encrypted GitHub Actions secret (INTERCOMDEVTOKEN) and expose it to the integration job as the INTERCOMACCESSTOKEN environment variable. The Intercom SDK and the /me connectivity check both send it as a bearer token in the Authorization: Bearer header. The unit-test job never receives a token — its SDK is fully mocked. Webhook verification uses a separate INTERCOMWEBHOOKSECRET HMAC secret. Instructions Read your existing package.json to confirm the test, typecheck, and test:integration scripts exist, then work through these steps. Write each file to the path shown; the deep reference files hold the full contents. Step 1: GitHub Actions workflow Write .github/workflows/intercom-ci.yml with two jobs — unit-tests (every push and PR) and integration-tests (gated to main pushes). The integration job first probes https://api.intercom.io/me and fails fast on a non-200: Full workflow YAML: references/workflow.md. Step 2: Configure secrets Store the dev token (and, if you verify webhooks, the signing secret) with the gh CLI, then confirm with gh secret list: Details and the webhook secret: references/workflow.md. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-ci-integration