Agent skill · software engineering · jeremylongshore
attio-sdk-patterns
Build a typed Attio REST client with tenant-aware tokens, endpoint-specific pagination, structured errors, bounded retries, and contract tests while distinguishing it from the Attio App SDK. Use when creating or refactoring Attio integration code. Trigger with "Attio SDK", "Attio client wrapper", or "typed Attio API".
Why this skill is useful
Adds a production-ready TypeScript SDK with error handling, retry logic, and pagination patterns for the Attio API that are not publicly documented.
What it needs
Requires node installed locally. Requires attio account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Attio Typed Client Patterns Overview This skill designs a small REST client around the endpoints an application actually uses. It does not conflate a server-side REST wrapper with Attio's attio App SDK for in-product apps. Prerequisites Runtime, package manager, and existing HTTP conventions Exact endpoints, methods, scopes, and response shapes Tenancy and credential model Existing tests and error-handling policy Tool Discipline Use Read, Glob, and Grep to inspect clients, types, dependency policy, and tests. Use WebFetch only for official Attio REST, OpenAPI, and App SDK documentation. Use Write or Edit after the target abstraction and endpoint contracts are confirmed. Current Contract Attio REST requests use the https://api.attio.com/v2 base URL and endpoint-specific scopes. Pagination is endpoint-specific: some operations use limit and offset, while others return a cursor such as pagination.nextcursor. The Attio App SDK package attio serves apps running inside Attio and is not a universal REST client replacement. Generated types can start from the official OpenAPI document, but application-level validation and tests still own runtime safety. Authentication Inject a token provider that resolves the authorized workspace at request time. Do not place a global production token in source, client constructors, snapshots, fixtures, or logs. Instructions 1. Inventory call sites and group the smallest useful endpoint surface. 2. Reverify each method, path, scope, body, response, and paginator in official documentation. 3. Define typed request and response boundaries with runtime validation for external data. 4. Centralize base URL, authorization, timeouts, redaction, request IDs, and structured error translation. 5. Implement separate offset and cursor iterators; bind each endpoint explicitly to the correct strategy. 6. Retry only eligible transient failures, respecting rate limits and mutation idempotency. 7. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/attio-sdk-patterns