Agent skill

Intercom Deploy Integration

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Deploy Intercom integrations to Vercel, Fly.io, and Cloud Run with proper secrets.

MITAuto-check passedBackend & APIs

Install Intercom Deploy Integration

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill intercom-deploy-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace intercom-deploy-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/intercom-deploy-integration .claude/skills/intercom-deploy-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
intercom-deploy-integration
GitHub stars
2.8k
Token cost
~1.6k tokens
SKILL.md length
615 words
Files
3 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Deploy Intercom integrations to Vercel, Fly.io, and Cloud Run with proper secrets.

  • Works in 5 steps: Choose a platform and provision secrets → Write the signed webhook handler → Add a Intercom-aware health check → …
  • Deploying Intercom-powered applications to production
  • SKILL.md covers Overview, Prerequisites, Authentication and Instructions, plus 6 more sections
  • Calls vercel, fly and gcloud; needs INTERCOM_WEBHOOK_SECRET and INTERCOM_ACCESS_TOKEN

What it does

Intercom Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Deploy Intercom integrations to Vercel, Fly.io, and Cloud Run with proper secrets. Use when deploying Intercom-powered applications to production, configuring platform-specific secrets, or setting up signed webhook endpoints and health checks. Trigger with phrases like "deploy intercom", "intercom Vercel", "intercom production deploy", "intercom Cloud Run", "intercom Fly.io".

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/examples.md` and `references/implementation.md`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Webhooks and Deployment. It works with Intercom, Cloud Run and Vercel. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Deploying Intercom-powered applications to production
  • Configuring platform-specific secrets
  • Setting up signed webhook endpoints and health checks
  • With phrases like deploy intercom

Example prompts

  • “deploy intercom”
  • “intercom Vercel”
  • “intercom production deploy”
  • “/intercom-deploy-integration”

Requirements

  • A credential in INTERCOM_ACCESS_TOKEN
  • A credential in INTERCOM_WEBHOOK_SECRET
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(vercel:*), Bash(fly:*), Bash(gcloud:*)

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Choose a platform and provision secrets
  2. Write the signed webhook handler
  3. Add a Intercom-aware health check
  4. Deploy
  5. Register the webhook URL

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(vercel:*)
    • Bash(fly:*)
    • Bash(gcloud:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • vercel
    • fly
    • gcloud
    • curl

    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):

    • developers.intercom.com
    • vercel.com
    • fly.io
    • cloud.google.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_WEBHOOK_SECRET
    • 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 Deploy Integration loads about 1.6k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 615 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.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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). 615 words, ~1,644 tokens.

Download SKILL.mdSave it as .claude/skills/intercom-deploy-integration/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
intercom-deploy-integration
description
Deploy Intercom integrations to Vercel, Fly.io, and Cloud Run with proper secrets. Use when deploying Intercom-powered applications to production, configuring platform-specific secrets, or setting up signed webhook endpoints and health checks. Trigger with phrases like "deploy intercom", "intercom Vercel", "intercom production deploy", "intercom Cloud Run", "intercom Fly.io".
allowed-tools
Read, Write, Edit, Bash(vercel:*), Bash(fly:*), Bash(gcloud:*)
compatibility
Designed for Claude Code
version
1.6.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, support, messaging, intercom

Intercom Deploy Integration

Overview

Deploy Intercom-powered applications to Vercel, Fly.io, or Google Cloud Run with proper secret management, signed webhook endpoints, and health checks. The workflow is the same across platforms — provision two secrets, deploy, wire a /health probe, then register the webhook URL — and each platform's copy-ready code lives in references/implementation.md.

Prerequisites

  • Intercom production access token
  • Platform CLI installed (vercel, flyctl, or gcloud)
  • Application with Intercom integration ready for deployment

Authentication

Two secrets drive every deployment. INTERCOM_ACCESS_TOKEN authenticates API calls (passed to the SDK as new IntercomClient({ token })); INTERCOM_WEBHOOK_SECRET is the Developer Hub signing secret used to verify inbound webhook payloads (HMAC-SHA1 over the raw body, compared against the X-Hub-Signature header). Store both in the platform's secret store — never hardcode them: vercel env add, fly secrets set, or Cloud Run Secret Manager. A mismatched webhook secret returns 401 Invalid signature; an invalid token surfaces as a degraded health check rather than a hard failure.

Instructions

Pick the platform that matches your stack. Each step below shows the essential skeleton; open references/implementation.md for the complete webhook handler, vercel.json, fly.toml, Cloud Run deploy script, and shared health-check code.

Step 1: Choose a platform and provision secrets
  • Vercel (serverless): vercel env add INTERCOM_ACCESS_TOKEN production then vercel env add INTERCOM_WEBHOOK_SECRET production.
  • Fly.io (long-running): fly secrets set INTERCOM_ACCESS_TOKEN=... INTERCOM_WEBHOOK_SECRET=....
  • Cloud Run (container): store both in Secret Manager and mount with --set-secrets.
Step 2: Write the signed webhook handler

Read the raw request body (disable body parsing), recompute the HMAC-SHA1 signature, and compare with crypto.timingSafeEqual. Return within 5 seconds — queue slower work:

typescript
const expected = "sha1=" + crypto
  .createHmac("sha1", process.env.INTERCOM_WEBHOOK_SECRET!)
  .update(rawBody)
  .digest("hex");
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) return res.status(401).end();

Write this to api/webhooks/intercom.ts (Vercel) or the equivalent route. Full handler, including the raw-body read and the Vercel config export, is in the Vercel section of references/implementation.md.

Step 3: Add a Intercom-aware health check

Expose a /health route that calls client.admins.list() and reports healthy / degraded with latency. Edit your platform config to wire it as the liveness probe (fly.toml checks block, or Cloud Run's default). Full code is in the Health Check section of references/implementation.md.

Step 4: Deploy

Run the platform deploy command: vercel --prod, fly deploy, or the gcloud run deploy script. Verify with curl https://your-domain.com/health.

Show full SKILL.md (261 more words)Show less
Step 5: Register the webhook URL

In Developer Hub > Webhooks, set the endpoint to https://your-domain.com/api/webhooks/intercom, select topics (see the reference table below), copy the signing secret into your platform secrets, and send a test notification to confirm a 200.

Webhook Topics Reference

TopicFires When
conversation.user.createdNew conversation from contact
conversation.user.repliedContact replies
conversation.admin.repliedAdmin replies
conversation.admin.closedConversation closed
contact.createdNew contact created
contact.signed_upLead converts to user
contact.tag.createdTag applied to contact
user.createdNew user (legacy topic)

Output

A successful run produces a deployed service reachable over HTTPS with:

  • Both INTERCOM_ACCESS_TOKEN and INTERCOM_WEBHOOK_SECRET stored in the platform's secret store (never in source).
  • A signature-verifying webhook endpoint returning 200 { "received": true } for valid payloads and 401 for bad signatures.
  • A /health endpoint returning {"status":"healthy","services":{"intercom":{"connected":true,"latencyMs":142}}}.
  • The webhook registered in Developer Hub with a passing test notification.

Error Handling

IssueCauseSolution
Webhook 401Signature mismatchVerify secret matches Developer Hub
Cold start timeoutServerless spin-upSet min instances > 0
Secret not foundMissing configVerify secrets with platform CLI
Health check failingToken invalid in prodVerify production token
Webhook delivery fails5s timeout exceededQueue events, process async

Examples

Start from the Vercel skeleton, then drill into the platform you're shipping to:

bash
vercel env add INTERCOM_ACCESS_TOKEN production
vercel env add INTERCOM_WEBHOOK_SECRET production
vercel --prod

Full end-to-end walkthroughs for Vercel, Fly.io, and Cloud Run — including expected output and how to read a failing test notification — are in references/examples.md.

Resources

Next Steps

For webhook payload handling and event-processing patterns after deployment, see the intercom-webhooks-events skill in this pack.

© 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-deploy-integration of jeremylongshore/tons-of-skills-marketplace.

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

Open the folder on GitHubat commit 23ea8d4

Compare with similar skills

Intercom Deploy Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Intercom Deploy Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Intercom Deploy Integration this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: PassMIT
Golivemikehasa/golive-skill1.2k—~13kAutomated safety check: NotesMIT
Channel Debug Corevercel-labs/vercel-openclaw-archived117—~2kAutomated safety check: NotesMIT
CI/CD Pipeline Principlesirahardianto/awesome-agv157—~2.7kAutomated safety check: NotesMIT
Ar Io Gateway Operatorar-io/ar-io-node127—~8.2kAutomated safety check: NotesAGPL-3.0
Tg Bot Opsserejaris/personal-corp-os229—~1.6kAutomated safety check: NotesMIT

Similar skills

  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.2k GitHub stars~13k tokensUpdated 4 days ago
    Backend & APIsAuto-check: notes
  • Channel Debug Core

    vercel-labs/vercel-openclaw-archived

    Official

    Channel webhook triage for vercel-openclaw Slack/Telegram/Discord/WhatsApp issues: prove deployment state, collect admin readiness endpoints, build evidence-first handoff before fixes.

    117 GitHub stars~2k tokensUpdated 4 mo ago
    Backend & APIsAuto-check: notes
  • CI/CD Pipeline Principles

    irahardianto/awesome-agv

    Rules for designing CI/CD pipelines in layers: universal lint, test and scan stages, container builds with SBOM attestation, and GitOps for orchestrated deployments.

    157 GitHub stars~2.7k tokensUpdated 3 days ago
    DevOps & CloudAuto-check: notes
  • Ar Io Gateway Operator

    ar-io/ar-io-node

    Operate any AR.IO node deployment — architecture, daily ops, diagnostics, and recurring pitfalls that apply to every operator.

    127 GitHub stars~8.2k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Tg Bot Ops

    serejaris/personal-corp-os

    A skill your agent uses when operating, debugging, deploying, or monitoring a Telegram bot or Telegram-to-agent gateway.

    229 GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Deploy Vercel

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when deploying or configuring this project on Vercel — env vars, build settings, serverless limits, and production checks for Next.js or Express.

    240 GitHub stars~660 tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Analyzing Text With NLP

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to perform natural language processing and text analysis using the nlp-text-analyzer plugin.

    2.8k GitHub starsUsed in 1 repo~819 tokens
    Auto-check passed
  • Building Neural Networks

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill allows AI assistant to construct and configure neural network architectures using the neural-network-builder plugin.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Detecting Data Anomalies

    jeremylongshore/tons-of-skills-marketplace

    Process identify anomalies and outliers in datasets using machine learning algorithms.

    2.8k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Explaining Machine Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill enables AI assistant to provide interpretability and explainability for machine learning models.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Optimizing Prompts

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill optimizes prompts for large language models (llms) to reduce token usage, lower costs, and improve performance.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

Categories

Questions about Intercom Deploy Integration

What does Intercom Deploy Integration do?

Deploy Intercom integrations to Vercel, Fly.io, and Cloud Run with proper secrets. Intercom Deploy Integration is an agent skill from jeremylongshore/tons-of-skills-marketplace.io, and Cloud Run with proper secrets.

When should I use Intercom Deploy Integration?

Intercom Deploy Integration fits situations like: deploying Intercom-powered applications to production; configuring platform-specific secrets; setting up signed webhook endpoints and health checks; with phrases like deploy intercom.

How do I install Intercom Deploy Integration in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill intercom-deploy-integration -a claude-code`. Or copy the skill folder (skills/.curated/intercom-deploy-integration in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/intercom-deploy-integration in your project. Claude Code loads it when a task matches its description.

How do I install Intercom Deploy Integration in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill intercom-deploy-integration -a codex`. Or copy the skill folder (skills/.curated/intercom-deploy-integration in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/intercom-deploy-integration in your project. Codex loads it when a task matches its description.

Can I use Intercom Deploy Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill intercom-deploy-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/intercom-deploy-integration, .gemini/skills/intercom-deploy-integration, .github/skills/intercom-deploy-integration and .opencode/skills/intercom-deploy-integration in your project.

What does Intercom Deploy Integration need to run?

Going by SKILL.md and its folder, Intercom Deploy Integration needs the command-line tools its instructions call (vercel, fly, gcloud and curl) and credentials named INTERCOM_WEBHOOK_SECRET and INTERCOM_ACCESS_TOKEN. Our summary lists: A credential in INTERCOM_ACCESS_TOKEN; A credential in INTERCOM_WEBHOOK_SECRET. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(vercel:*), Bash(fly:*), Bash(gcloud:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Intercom Deploy Integration access the network?

SKILL.md names 4 domains. As links in the text: developers.intercom.com, vercel.com, fly.io and cloud.google.com. This is read from the text; nothing was executed.

Is Intercom Deploy Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Intercom Deploy Integration use?

Intercom Deploy Integration is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Intercom Deploy Integration use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Intercom Deploy Integration?

Skills that share tags, products or a category with Intercom Deploy Integration: Golive (mikehasa/golive-skill, 1.2k stars), Channel Debug Core (vercel-labs/vercel-openclaw-archived, 117 stars), CI/CD Pipeline Principles (irahardianto/awesome-agv, 157 stars) and Ar Io Gateway Operator (ar-io/ar-io-node, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Intercom Deploy Integration?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,821 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 8, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.