Agent skill

Intercom Install Auth

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

Install and configure Intercom API authentication with access tokens or OAuth.

MITAuto-check: notesBackend & APIs

Install Intercom Install Auth

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

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

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

At a glance

Install and configure Intercom API authentication with access tokens or OAuth.

  • Works in 4 steps: Install the SDK → Configure Access Token Authentication → Verify Connection → …
  • Setting up a new Intercom integration
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 4 more sections
  • Calls npm; needs INTERCOM_ACCESS_TOKEN and INTERCOM_CLIENT_SECRET

What it does

Intercom Install Auth is an agent skill from jeremylongshore/tons-of-skills-marketplace. Install and configure Intercom API authentication with access tokens or OAuth. Use when setting up a new Intercom integration, configuring API credentials, or initializing the intercom-client SDK in your project. Trigger with phrases like "install intercom", "setup intercom", "intercom auth", "configure intercom API key", "intercom access token".

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

It sits in Backend & APIs, covering OAuth and OpenID Connect and Authentication. It works with Intercom and npm. 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

  • Setting up a new Intercom integration
  • Configuring API credentials
  • Initializing the intercom-client SDK in your project
  • With phrases like install intercom

Example prompts

  • “install intercom”
  • “setup intercom”
  • “intercom auth”
  • “/intercom-install-auth”

Requirements

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

Workflow steps

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

  1. Install the SDK
  2. Configure Access Token Authentication
  3. Verify Connection
  4. OAuth Setup (Public Apps)

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. 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:

    • Write
    • Bash(npm:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    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
    • npmjs.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
    • INTERCOM_CLIENT_SECRET

    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 Install Auth loads about 1.2k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 93 tokens; SKILL.md has 406 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
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.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

Auto-check: notes

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

  • NoteMentions a .env fileSKILL.md:24
    s Write to create the client config and `.env`, and verifies the connection.
  • NoteMentions a .env fileSKILL.md:45
    Write to create the client module and a `.env` holding the token (add `.env` to `.gitignore`):
  • NoteMentions a .env fileSKILL.md:55
    d](references/examples.md) for the full `.env` setup and secure-storage steps.
  • NoteMentions a .env fileSKILL.md:84
    - A `.env` holding `INTERCOM_ACCESS_TOKEN` (private app) or `INTERCOM_CLIENT_ID` / `INTERCOM_CLIENT_SECRET` (OAuth), wit

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 80f86df, republished under its MIT licence (© jeremylongshore). 406 words, ~1,235 tokens.

Download SKILL.mdSave it as .claude/skills/intercom-install-auth/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
intercom-install-auth
description
Install and configure Intercom API authentication with access tokens or OAuth. Use when setting up a new Intercom integration, configuring API credentials, or initializing the intercom-client SDK in your project. Trigger with phrases like "install intercom", "setup intercom", "intercom auth", "configure intercom API key", "intercom access token".
allowed-tools
Write, Bash(npm:*)
compatibility
Designed for Claude Code
version
1.6.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, support, messaging, intercom

Intercom Install & Auth

Overview

Set up the official intercom-client TypeScript SDK and configure authentication via access tokens (private apps) or OAuth (public apps). This skill installs the SDK with a Bash npm command, uses Write to create the client config and .env, and verifies the connection.

Prerequisites

  • Node.js 18+
  • npm, pnpm, or yarn
  • Intercom workspace with Developer Hub access
  • Access token from Configure > Authentication in your app settings

Instructions

Step 1: Install the SDK
bash
npm install intercom-client

The package exports IntercomClient and all TypeScript types under the Intercom namespace.

Step 2: Configure Access Token Authentication

Access tokens authenticate private apps that access your own Intercom workspace. Use Write to create the client module and a .env holding the token (add .env to .gitignore):

typescript
import { IntercomClient } from "intercom-client";

const client = new IntercomClient({
  token: process.env.INTERCOM_ACCESS_TOKEN!,
});

See examples.md for the full .env setup and secure-storage steps.

Step 3: Verify Connection

List admins to confirm the token authenticates end-to-end:

typescript
const admins = await client.admins.list();
console.log("Connected! Admins:", admins.admins.length);

The complete verification function (with error handling and expected output) is in examples.md.

Step 4: OAuth Setup (Public Apps)

For a public app that accesses other workspaces, run the OAuth authorization → token-exchange flow, then initialize the client with the returned token:

typescript
const client = new IntercomClient({ token: oauthToken });

Full OAuth exchange, API-version pinning, and the scope matrix are in oauth.md.

Output

Running this skill produces:

  • intercom-client installed in node_modules and added to package.json.
  • A configured IntercomClient module authenticated via access token or OAuth.
  • A .env holding INTERCOM_ACCESS_TOKEN (private app) or INTERCOM_CLIENT_ID / INTERCOM_CLIENT_SECRET (OAuth), with .env gitignored.
  • A verified connection — client.admins.list() returns your workspace admins, confirming the token and API version (2.11, applied automatically by the SDK) are correct.
Show full SKILL.md (153 more words)Show less

Error Handling

Common authentication failures and fixes:

ErrorHTTP CodeCauseSolution
unauthorized401Invalid or expired tokenRegenerate in Developer Hub
forbidden403Missing OAuth scopeAdd required scope in app config
token_revoked401Token was revokedGenerate new access token
invalid_grant400OAuth code expiredRestart OAuth flow

Catch IntercomError to branch on statusCode — the full typed pattern is in error-handling.md.

Examples

See examples.md for three worked setups: the access-token client (private app, the common path), a connection-verify function with expected output, and an OAuth client (public app).

Minimal working setup:

typescript
import { IntercomClient } from "intercom-client";

const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN! });
const admins = await client.admins.list();
console.log("Connected! Admins:", admins.admins.length);

Resources

Next Steps

After successful authentication, proceed to the intercom-hello-world skill to make your first API call — create a contact, then fetch it back to confirm read and write both work with your configured client.

© 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 3 other files (references) in skills/.curated/intercom-install-auth of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/error-handling.md
  • references/examples.md
  • references/oauth.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Intercom Install Auth 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 Install Auth compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Intercom Install Auth this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: NotesMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
Cognitoitsmostafa/aws-agent-skills1.2k1 repos~2.3kAutomated safety check: PassMIT
Security Reviewdoorkeeper-gem/doorkeeper5.5k—~1.4kAutomated safety check: PassMIT
OAuth Account Setupspinabot/brigade11k—~878Automated safety check: PassMIT
Auth Implementation Patternsynulihao/AgentSkillOS61710 repos~4.4kAutomated safety check: PassNone

Similar skills

  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • Cognito

    itsmostafa/aws-agent-skills

    AWS Cognito user authentication and authorization service. An agent skill from itsmostafa/aws-agent-skills.

    1.2k GitHub starsUsed in 1 repo~2.3k tokens
    Backend & APIsAuto-check passed
  • Security Review

    doorkeeper-gem/doorkeeper

    Verify that code changes do not introduce OAuth security vulnerabilities.

    5.5k GitHub stars~1.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • OAuth Account Setup

    spinabot/brigade

    Connects an OAuth 2.0 account such as Gmail with the built-in oauth_authorize tool: an authorization link, automatic code capture and sealed token storage.

    11k GitHub stars~878 tokensUpdated today
    Backend & APIsAuto-check passed
  • Auth Implementation Patterns

    ynulihao/AgentSkillOS

    Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems.

    617 GitHub starsUsed in 10 repos~4.4k tokens
    Backend & APIsAuto-check passed
  • Socialite Development

    hexlet-volunteers/hexlet-sicp

    Manages OAuth social authentication with Laravel Socialite. An agent skill from hexlet-volunteers/hexlet-sicp.

    114 GitHub starsUsed in 5 repos~1.2k tokens
    Backend & APIsAuto-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
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Intercom Install Auth

What does Intercom Install Auth do?

Install and configure Intercom API authentication with access tokens or OAuth. Intercom Install Auth is an agent skill from jeremylongshore/tons-of-skills-marketplace. Install and configure Intercom API authentication with access tokens or OAuth.

When should I use Intercom Install Auth?

Intercom Install Auth fits situations like: setting up a new Intercom integration; configuring API credentials; initializing the intercom-client SDK in your project; with phrases like install intercom.

How do I install Intercom Install Auth in Claude Code?

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

How do I install Intercom Install Auth in Codex?

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

Can I use Intercom Install Auth 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-install-auth -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-install-auth, .gemini/skills/intercom-install-auth, .github/skills/intercom-install-auth and .opencode/skills/intercom-install-auth in your project.

What does Intercom Install Auth need to run?

Going by SKILL.md and its folder, Intercom Install Auth needs the command-line tools its instructions call (npm) and credentials named INTERCOM_ACCESS_TOKEN and INTERCOM_CLIENT_SECRET. Our summary lists: Node.js; A credential in INTERCOM_ACCESS_TOKEN; A credential in INTERCOM_CLIENT_SECRET. Its frontmatter pre-approves these tools: Write, Bash(npm:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Intercom Install Auth access the network?

SKILL.md names 2 domains. As links in the text: developers.intercom.com and npmjs.com. This is read from the text; nothing was executed.

Is Intercom Install Auth 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 Install Auth use?

Intercom Install Auth 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 Install Auth use?

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

What are the alternatives to Intercom Install Auth?

Skills that share tags, products or a category with Intercom Install Auth: Fortify Development (coollabsio/coolify, 63k stars), Cognito (itsmostafa/aws-agent-skills, 1.2k stars), Security Review (doorkeeper-gem/doorkeeper, 5.5k stars) and OAuth Account Setup (spinabot/brigade, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Intercom Install Auth?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 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.