attio-sdk-patterns
/attio-sdk-patterns
Buduje typowany klient Attio REST z tokenami per tenant, paginacją per endpoint, ustrukturyzowanymi błędami, ograniczonymi ponowieniami i testami kontraktowymi, odróżniając go od Attio App SDK.
- Autor
- jeremylongshore ↗
- Repozytorium
- tons-of-skills-marketplace ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 4
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Buduje typowany klient Attio REST z tokenami per tenant, paginacją per endpoint, ustrukturyzowanymi błędami, ograniczonymi ponowieniami i testami kontraktowymi, odróżniając go od Attio App SDK.
Wyzwalacze z opisu
Argumenty
/attio-sdk-patterns [repository-path] [language-or-runtime]
Oryginalny opis (EN)
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".
Jak działa
- Overview
- Prerequisites
- Tool Discipline
- Current Contract
- Authentication
- Instructions
- Approval Boundaries
- Output
- Error Handling
- Examples
Podgląd SKILL.md
--- name: attio-sdk-patterns description: >- 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". argument-hint: "[repository-path] [language-or-runtime]" allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit version: 1.8.0 author: Jeremy Longshore <jeremy@intentsolutions.io> license: MIT tags: - saas - attio - sdk model: inherit effort: high compatibility: Designed for Claude Code --- # 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.next_cursor`. - 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. Add fixture, pagination-termination, error, redaction, and tenant-isolation tests. ## Approval Boundaries Do not replace an established client, add a generated dependency, or migrate production call sites without owner approval and compatibility evidence. ## Output Return the endpoint inventory, client interface, pagination mapping, error taxonomy, auth boundary, test evidence, migration plan, and rollback point. ## Error Handling | Condition | Response | |---|---| | Endpoint contract is ambiguous | Stop and recheck the official endpoint reference. | | Runtime payload fails validation | Return a typed contract error and preserve redacted evidence. | | Pagination repeats a page | Abort at the loop guard and record the endpoint strategy. | | Tenant token does not match context | Reject before sending the request. | ## Examples Input: ```text runtime=TypeScript; endpoints=record query and task create; tenancy=multi-workspace ``` Expected handoff: ```text client=typed REST wrapper; pagination=endpoint mapped; tenant-tests=pass ``` ## Resources - [Skill-specific official documentation](references/official-docs.md) - [OpenAPI specification](https://docs.attio.com/rest-api/endpoint-reference/openapi) - [Pagination](https://docs.attio.com/rest-api/guides/pagination) - [App SDK overview](https://docs.attio.com/sdk/deep-dives/overview)
Pliki w paczce (2)
- SKILL.md 4 KB
- references/official-docs.md 2 KB
Wersje
W bazie nie ma innych skilli o nazwie attio-sdk-patterns.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki e6533a1777fd (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100attio-common-errors
Diagnozuje awarie API REST Attio na podstawie statusu, pól błędu, kontraktu endpointu i kontekstu żądania, bez ujawniania danych klientów, przy kodach 400, 401, 403, 404, 409, 422, 429 i 5xx. - 100attio-rate-limits
Analizuje i projektuje regulator żądań Attio z osobnymi budżetami odczytu i zapisu, ograniczonymi ponowieniami i obserwowalnym backpressure, np. przy odpowiedziach 429. - 100attio-webhooks
Odbiera i weryfikuje webhooki Attio CRM, w tym podpis Attio-Signature i deduplikację przez Idempotency-Key, oraz obsługuje zdarzenia record.created, list-entry.created, note.created i task.created. - 100attio-skill-generator
Generuje skille workflow dla Attio na podstawie szablonów, przy tworzeniu nowych procesów kwalifikacji leadów, zarządzania dealami i onboardingu klientów. - 85taste-attio
Odwzorowuje estetykę, typografię, tokeny kolorów i komponenty serwisu attio.com przy budowie stron i interfejsów. - 100attio
Integruje Attio przez ujednolicone API CRM Apideck: odczyt, zapis i wyszukiwanie kontaktów, firm, leadów, szans, aktywności i pipeline'ów, z serviceId attio.