Agent skill

Intercom Debug Bundle

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

Collect Intercom debug evidence for support tickets and troubleshooting.

MITAuto-check: notesSales & Support

Install Intercom Debug Bundle

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

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace intercom-debug-bundle --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-debug-bundle .claude/skills/intercom-debug-bundle && 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-debug-bundle
GitHub stars
2.8k
Token cost
~1.2k tokens
SKILL.md length
440 words
Files
3 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Collect Intercom debug evidence for support tickets and troubleshooting.

  • Works in 3 steps: Confirm auth before collecting → Run the full bundle collector → Redact and review before sharing
  • Encountering persistent Intercom API issues
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 5 more sections
  • Calls curl, apt and brew; reaches status.intercom.com and api.intercom.io; needs INTERCOM_ACCESS_TOKEN

What it does

Intercom Debug Bundle is an agent skill from jeremylongshore/tons-of-skills-marketplace. Collect Intercom debug evidence for support tickets and troubleshooting. Use when encountering persistent Intercom API issues, auth or rate-limit failures, or preparing a diagnostic bundle to attach to an Intercom support ticket. Trigger with phrases like "intercom debug", "intercom support bundle", "collect intercom logs", "intercom diagnostic", "intercom troubleshoot".

Its SKILL.md is about 1.2k 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 Sales & Support, covering Customer support and Rate limiting. It works with Intercom. 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

  • Encountering persistent Intercom API issues
  • Rate-limit failures
  • Preparing a diagnostic bundle to attach to an Intercom support ticket
  • With phrases like intercom debug

Example prompts

  • “intercom debug”
  • “intercom support bundle”
  • “collect intercom logs”
  • “/intercom-debug-bundle”

Requirements

  • A credential in INTERCOM_ACCESS_TOKEN
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Bash(grep:*), Bash(curl:*), Bash(tar:*), Bash(npm:*), Bash(node:*)

Workflow steps

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

  1. Confirm auth before collecting
  2. Run the full bundle collector
  3. Redact and review before sharing

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:

    • Bash(grep:*)
    • Bash(curl:*)
    • Bash(tar:*)
    • Bash(npm:*)
    • Bash(node:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • apt
    • brew

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • status.intercom.com
    • api.intercom.io

    Also links to:

    • intercom.com
    • developers.intercom.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 Debug Bundle loads about 1.2k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 440 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

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

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:59
    emails, and `.env` values are stripped before packaging.
  • NoteMentions a .env fileSKILL.md:76
    - `config-redacted.txt` — `.env` copy with all values masked (present only if `.env` exists)

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). 440 words, ~1,199 tokens.

Download SKILL.mdSave it as .claude/skills/intercom-debug-bundle/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
intercom-debug-bundle
description
Collect Intercom debug evidence for support tickets and troubleshooting. Use when encountering persistent Intercom API issues, auth or rate-limit failures, or preparing a diagnostic bundle to attach to an Intercom support ticket. Trigger with phrases like "intercom debug", "intercom support bundle", "collect intercom logs", "intercom diagnostic", "intercom troubleshoot".
allowed-tools
Bash(grep:*), Bash(curl:*), Bash(tar:*), Bash(npm:*), Bash(node:*)
compatibility
Designed for Claude Code
version
1.6.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, support, messaging, intercom

Intercom Debug Bundle

Overview

Collect diagnostic evidence for Intercom issues: API health, auth status, rate-limit headers, SDK version, platform incidents, and redacted logs — packaged as a timestamped tarball safe to attach to a support ticket. Most persistent failures are auth (401) or rate-limit (429) problems, so the bundle leads with the /me health check before collecting anything heavier.

Prerequisites

  • Intercom access token exported as INTERCOM_ACCESS_TOKEN
  • curl and jq available
  • Access to application logs (optional — the collector redacts them)

Instructions

Step 1: Confirm auth before collecting

Most failed bundles are a bad token. Confirm /me returns 200 first; if not, fix auth before running the full collector.

bash
TOKEN="${INTERCOM_ACCESS_TOKEN:?set INTERCOM_ACCESS_TOKEN and re-run}"
curl -s -o /dev/null -w "Auth HTTP: %{http_code}\n" \
  -H "Authorization: Bearer $TOKEN" \
  https://api.intercom.io/me
# 200 = OK, 401 = regenerate the token in the Developer Hub
Step 2: Run the full bundle collector

When the quick check passes, run the seven-step collector. It writes token status, auth JSON, rate-limit headers, platform status and active incidents, environment/SDK info, endpoint latencies, and redacted logs into a timestamped directory, then tars it up as intercom-debug-YYYYMMDD-HHMMSS.tar.gz. Tokens, emails, and .env values are stripped before packaging.

See the complete intercom-debug-bundle.sh script (all seven steps) in full implementation.

Step 3: Redact and review before sharing

The collector redacts as it goes, but review the tarball before attaching it to a ticket. What to ALWAYS redact vs what is SAFE TO INCLUDE (with copy-paste curl snippets for reading rate-limit headers and capturing a request_id) lives in examples and redaction rules.

Output

  • intercom-debug-YYYYMMDD-HHMMSS.tar.gz containing:
    • summary.txt — token status, auth result, rate-limit headers, platform status, active incident count, environment, SDK version, and per-endpoint latency (/me, /contacts, /conversations, /admins)
    • logs-redacted.txt — recent Intercom-related log lines with tokens and emails masked (present only if logs/app.log exists)
    • config-redacted.txt — .env copy with all values masked (present only if .env exists)
Show full SKILL.md (165 more words)Show less

Sensitive Data Policy

ALWAYS redact: access tokens, OAuth secrets, webhook signing secrets, email addresses and PII, customer conversation content.

Safe to include: HTTP status/error codes, request_id from error responses (Intercom support needs these), rate-limit header values, SDK/runtime versions, endpoint latencies. Full rules in examples and redaction rules.

Error Handling

IssueCauseSolution
jq: command not foundjq not installedapt install jq or brew install jq
Auth test returns 401Token invalidRegenerate in Developer Hub
Status page unreachableNetwork issueTry curl https://status.intercom.com directly
No rate limit headersRequest failed earlyFix auth first

Examples

Quick reference for the most common check — confirm the token authenticates:

bash
curl -s -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Bearer $INTERCOM_ACCESS_TOKEN" \
  https://api.intercom.io/me
# 200 = OK, 401 = regenerate token

For reading rate-limit headers, capturing a request_id from an error response, and the full redaction rules, see examples and redaction rules.

Resources

Next Steps

For rate limit handling, see intercom-rate-limits. For auth setup, see intercom-install-auth.

© 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-debug-bundle 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 Debug Bundle 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 Debug Bundle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Intercom Debug Bundle this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: NotesMIT
Support Ticket Triagecomposio-community/awesome-codex-skills17k—~364Automated safety check: PassNone
Siftranknoperator/siftrank224—~2.9kAutomated safety check: PassMIT
Supporthaacked/dotfiles134—~2.9kAutomated safety check: PassNone
Customer Support Agentmastra-ai/mastra29k—~2.2kAutomated safety check: PassCustom licence
Add Agent Adaptersafedep/gryph172—~679Automated safety check: PassApache-2.0

Similar skills

  • Support Ticket Triage

    composio-community/awesome-codex-skills

    Triage customer support tickets/emails/chats into categories, priority, and next action; draft responses and create reproducible steps; use for Zendesk/Intercom/Help Scout exports or pasted threads.

    17k GitHub stars~364 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Siftrank

    noperator/siftrank

    Find needles in haystacks with SiftRank. An agent skill from noperator/siftrank.

    224 GitHub stars~2.9k tokensUpdated 18 days ago
    Sales & SupportAuto-check passed
  • Support

    haacked/dotfiles

    Support hero workflow — start a ticket investigation with auto-organized notes, find existing notes, or generate the weekly highlights log.

    134 GitHub stars~2.9k tokensUpdated today
    Sales & SupportAuto-check passed
  • Customer Support Agent

    mastra-ai/mastra

    Authoring playbook for building agents that triage and reply to customer messages — support tickets, email inquiries, chat questions, refund requests, or product issues.

    29k GitHub stars~2.2k tokensUpdated today
    Sales & SupportAuto-check passed
  • Add Agent Adapter

    safedep/gryph

    A skill your agent uses when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired.

    172 GitHub stars~679 tokensUpdated 3 days ago
    Sales & SupportAuto-check passed
  • Agent Support Matrix

    jazzyalex/agent-sessions

    Maintain Agent Sessions agent support matrix and JSON/JSONL parsing compatibility.

    893 GitHub stars~587 tokensUpdated today
    Sales & SupportAuto-check passed

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

Works with

Categories

Questions about Intercom Debug Bundle

What does Intercom Debug Bundle do?

Collect Intercom debug evidence for support tickets and troubleshooting. Intercom Debug Bundle is an agent skill from jeremylongshore/tons-of-skills-marketplace. Collect Intercom debug evidence for support tickets and troubleshooting.

When should I use Intercom Debug Bundle?

Intercom Debug Bundle fits situations like: encountering persistent Intercom API issues; rate-limit failures; preparing a diagnostic bundle to attach to an Intercom support ticket; with phrases like intercom debug.

How do I install Intercom Debug Bundle in Claude Code?

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

How do I install Intercom Debug Bundle in Codex?

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

Can I use Intercom Debug Bundle 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-debug-bundle -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-debug-bundle, .gemini/skills/intercom-debug-bundle, .github/skills/intercom-debug-bundle and .opencode/skills/intercom-debug-bundle in your project.

What does Intercom Debug Bundle need to run?

Going by SKILL.md and its folder, Intercom Debug Bundle needs the command-line tools its instructions call (curl, apt and brew) and credentials named INTERCOM_ACCESS_TOKEN. Our summary lists: A credential in INTERCOM_ACCESS_TOKEN. Its frontmatter pre-approves these tools: Bash(grep:*), Bash(curl:*), Bash(tar:*), Bash(npm:*), Bash(node:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Intercom Debug Bundle access the network?

SKILL.md names 4 domains. In commands or code: status.intercom.com and api.intercom.io; the agent is likely to contact these when it follows the instructions. As links in the text: intercom.com and developers.intercom.com. This is read from the text; nothing was executed.

Is Intercom Debug Bundle safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Intercom Debug Bundle use?

Intercom Debug Bundle 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 Debug Bundle use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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.6k tokens, read only when the agent opens those files.

What are the alternatives to Intercom Debug Bundle?

Skills that share tags, products or a category with Intercom Debug Bundle: Support Ticket Triage (composio-community/awesome-codex-skills, 17k stars), Siftrank (noperator/siftrank, 224 stars), Support (haacked/dotfiles, 134 stars) and Customer Support Agent (mastra-ai/mastra, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Intercom Debug Bundle?

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.