Agent skill · software engineering · jeremylongshore
instantly-sdk-patterns
Use the official beta Instantly TypeScript SDK with pinned versions, typed resources, and safe error handling. Use when implementing or reviewing a Node.js client against API v2. Trigger with "use the Instantly TypeScript SDK", "build an Instantly Node client", or "handle Instantly SDK errors".
Why this skill is useful
Adds production-ready TypeScript and Python API client patterns for Instantly, including error handling and type safety that are not publicly documented.
What it needs
Requires npm installed locally. Requires instantly account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Instantly Official SDK Patterns Overview Adopt @instantlyai/sdk without inventing resource methods or hiding HTTP failure semantics. Record assumptions, evidence, approval state, and rollback ownership so another operator can reproduce the result. Prerequisites The target repository, Instantly workspace, environment, and accountable owner Current security, privacy, compliance, capacity, and change-control requirements An approved API v2 key only when a bounded live verification is necessary Tool Discipline Use Read, Glob, and Grep to inspect code, configuration, and evidence. Use WebFetch only for current first-party Instantly documentation and package metadata. Use Write or Edit only when implementation was requested and exact target files are known; never write credentials, lead data, email content, or unrestricted environment output. Current Contract The official package is @instantlyai/sdk and remains beta before stable 1.0.0. The SDK requires Node.js 22 or later and throws ResponseError for non-success responses. Resource coverage is generated from the OpenAPI schema and may evolve during beta. Authentication Use an API v2 key as Authorization: Bearer <key> against https://api.instantly.ai/api/v2. Grant only the endpoint-specific scopes needed, inject the key from an approved server-side secret manager, and never print, persist, commit, or place it in a URL. Treat key creation, rotation, revocation, member changes, workspace delegation, and production access as owner-approved actions. Instructions 1. Inspect runtime and lockfile compatibility before installing the beta package. 2. Confirm the current beta version and pin the resolved lockfile. 3. Create Instantly with a server-side apiKey and no browser exposure. 4. Use generated resource methods and request types that exist in the installed version. 5. Handle ResponseError by status while redacting response bodies and authorization. 6. Add contract tests and a deliberate upgrade review for every beta change. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/instantly-sdk-patterns