Agent skill · software engineering · jeremylongshore
intercom-prod-checklist
Execute Intercom production readiness checklist and rollback procedures.
Why this skill is useful
Adds a comprehensive executable checklist and rollback procedures specifically for deploying Intercom integrations, which the AI cannot generate on its own.
What it needs
Requires curl, jq installed locally. Requires intercom account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Intercom Production Checklist Overview Complete checklist for deploying Intercom integrations to production, covering authentication, error handling, rate limits, webhooks, and monitoring. Work the pre-deployment checklist below section by section, run the pre-flight script as the go-live gate, and keep the rollback procedure ready before you launch. Prerequisites A production Intercom workspace with an access token issued from the Developer Hub. $INTERCOMACCESSTOKEN exported in the environment where you run the checks. curl and jq available for the pre-flight and status probes. The integration deployed behind a feature flag so it can be disabled without a redeploy. (Optional) $WEBHOOKURL set if the integration receives Intercom webhooks. Instructions Work through the checklist in order. Each group gates a distinct failure class — do not skip a group because "it probably works." Authentication and secrets [ ] Production access token stored in secret manager (not env files) [ ] Token has minimal required OAuth scopes [ ] Token rotation procedure documented and tested [ ] Separate tokens for dev/staging/production workspaces [ ] No hardcoded tokens in source code (verified with grep -r "dG9r" .) API integration quality [ ] All API calls wrapped in error handling (try/catch with IntercomError) [ ] 429 rate limit retry with exponential backoff implemented [ ] 5xx server error retry implemented [ ] Request timeouts configured (recommended: 30s) [ ] Pagination handles cursor-based iteration correctly [ ] Contact search uses compound queries efficiently Webhook endpoints [ ] Webhook URL uses HTTPS (Intercom requires it) [ ] X-Hub-Signature verification implemented (HMAC-SHA1) [ ] Webhook handler responds within 5 seconds (Intercom timeout) [ ] Idempotency: duplicate webhooks handled gracefully [ ] Failed webhook retry handled (Intercom retries once after 1 min) Data handling [ ] PII redacted from logs (emails, names, phone numbers) [ ] Contact data cached with appropriate …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-prod-checklist