Agent skill

Attio Reference Architecture

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

Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership.

MITAuto-check passedBackend & APIs

Install Attio Reference Architecture

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill attio-reference-architecture -a claude-code

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

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

At a glance

Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership.

  • Works in 7 steps: Map ingress, egress, data stores, trust… → Define a credential resolver and… → Add a bounded schema registry or cache… → …
  • Reviewing a multi-workspace Attio service
  • SKILL.md covers Overview, Prerequisites, Tool Discipline and Current Contract, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Attio Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership. Use when planning or reviewing a multi-workspace Attio service. Trigger with "Attio architecture", "design Attio integration", or "Attio system design".

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Webhooks and Accounting and bookkeeping. 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

  • Reviewing a multi-workspace Attio service
  • With Attio architecture
  • Design Attio integration
  • Attio system design

Example prompts

  • “Attio architecture”
  • “design Attio integration”
  • “Attio system design”
  • “/attio-reference-architecture”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, WebFetch, Write, Edit

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Map ingress, egress, data stores, trust boundaries, tenant context, and failure domains from the repository.
  2. Define a credential resolver and auditable endpoint-to-scope map.
  3. Add a bounded schema registry or cache with explicit refresh and invalidation.
  4. Route outbound mutations through idempotent jobs with separate read and write governors.
  5. Terminate webhooks at an HTTPS receiver that verifies the raw body, deduplicates by idempotency key, acknowledges quickly, and queues work.
  6. Add replay, dead-letter handling, periodic reconciliation, and operator-visible lag metrics.
  7. Specify deployment order, canary cohort, rollback, recovery exercise, and component owners.

What it can do on your machine

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

    • Read
    • Glob
    • Grep
    • WebFetch
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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):

    • docs.attio.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    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

Attio Reference Architecture loads about 1k tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

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 passed

The automated check found no risky patterns in SKILL.md.

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 cfae287, republished under its MIT licence (© jeremylongshore). 381 words, ~1,028 tokens.

Download SKILL.mdSave it as .claude/skills/attio-reference-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
attio-reference-architecture
description
Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership. Use when planning or reviewing a multi-workspace Attio service. Trigger with "Attio architecture", "design Attio integration", or "Attio system design".
allowed-tools
Read, Glob, Grep, WebFetch, Write, Edit
compatibility
Designed for Claude Code
argument-hint
[repository-path] [single-workspace|multi-workspace]
version
1.8.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
saas, attio, architecture
model
inherit
effort
high

Attio Integration Reference Architecture

Overview

This skill produces a repo-grounded architecture for reliable Attio reads, writes, and events. It treats tenant isolation, duplicate delivery, schema evolution, and reconciliation as first-class controls.

Prerequisites

  • Workspace and tenancy model
  • Required objects, lists, attributes, records, entries, and events
  • Availability, freshness, recovery, and retention objectives
  • Owners for credentials, queues, data mapping, and incident response

Tool Discipline

Use Read, Glob, and Grep to map components, trust boundaries, state, and existing clients. Use WebFetch only for current official Attio contracts. Use Write or Edit after the architecture, ownership, and approval boundaries are agreed.

Current Contract

  • Use OAuth for multi-workspace applications and a workspace key only for a controlled single-workspace integration.
  • Discover object and attribute identifiers rather than hard-coding display labels.
  • Pagination differs by endpoint, and record or entry queries can carry score-based rate cost.
  • Webhooks are at-least-once signals; durable processing needs signature verification, idempotency, a queue, and reconciliation.

Authentication

Place a tenant credential resolver behind a server-side interface. Bind each encrypted token to one workspace identity and exact scopes; never accept a workspace identifier from a caller without authorization.

Show full SKILL.md (199 more words)Show less

Instructions

  1. Map ingress, egress, data stores, trust boundaries, tenant context, and failure domains from the repository.
  2. Define a credential resolver and auditable endpoint-to-scope map.
  3. Add a bounded schema registry or cache with explicit refresh and invalidation.
  4. Route outbound mutations through idempotent jobs with separate read and write governors.
  5. Terminate webhooks at an HTTPS receiver that verifies the raw body, deduplicates by idempotency key, acknowledges quickly, and queues work.
  6. Add replay, dead-letter handling, periodic reconciliation, and operator-visible lag metrics.
  7. Specify deployment order, canary cohort, rollback, recovery exercise, and component owners.

Approval Boundaries

Do not broaden data collection, scopes, retention, tenant access, or mutation authority without approval from the relevant data and service owners.

Output

Return a component-and-data-flow design, trust boundaries, endpoint contracts, failure controls, ownership matrix, rollout sequence, and rollback plan.

Error Handling

ConditionResponse
Tenant cannot be resolved safelyReject the operation before credential lookup.
Schema cache is staleRefresh discovery and pause incompatible writes.
Webhook queue is unavailableFail closed so Attio can retry; preserve observability.
Reconciliation finds driftQuarantine conflicting mutations and assign an owner.

Examples

Input:

text
tenancy=multi-workspace; flows=record sync and webhooks; recovery=required

Expected handoff:

text
auth=oauth resolver; writes=queued; webhooks=verified; reconciliation=scheduled

Resources

© 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 1 other file (references) in skills/.curated/attio-reference-architecture of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Attio Reference Architecture 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.

Attio Reference Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Attio Reference Architecture this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1kAutomated safety check: PassMIT
Pp Squaremvanhorn/printing-press-library2.1k—~15kAutomated safety check: NotesApache-2.0
Plaid Fintechsickn33/agentic-awesome-skills47k2 repos~467Automated safety check: PassMIT
Pakistan Payments Stacksickn33/agentic-awesome-skills47k2 repos~2kAutomated safety check: PassMIT
Signalsalsk1992/CloddsBot3k—~720Automated safety check: PassMIT
Int Omieevolution-foundation/evo-nexus545—~590Automated safety check: PassCustom licence

Similar skills

  • Pp Square

    mvanhorn/printing-press-library

    The current Square v2 API surface, plus local reconciliation and retained history.

    2.1k GitHub stars~15k tokensUpdated yesterday
    Business, Finance & HRAuto-check: notes
  • Plaid Fintech

    sickn33/agentic-awesome-skills

    Expert patterns for Plaid API integration including Link token flows, transactions sync, identity verification, Auth for ACH, balance checks, webhook handling, and fintech compliance best practices.

    47k GitHub starsUsed in 2 repos~467 tokens
    Backend & APIsAuto-check passed
  • Pakistan Payments Stack

    sickn33/agentic-awesome-skills

    Design and implement production-grade Pakistani payment integrations (JazzCash, Easypaisa, bank/PSP rails, optional Raast) for SaaS with PKR billing, webhook reliability, and reconciliation.

    47k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Signals

    alsk1992/CloddsBot

    Signal trading - RSS, Twitter, Telegram triggers to trades. An agent skill from alsk1992/CloddsBot.

    3k GitHub stars~720 tokensUpdated 8 days ago
    Backend & APIsAuto-check passed
  • Int Omie

    evolution-foundation/evo-nexus

    Omie ERP integration via API. An agent skill from evolution-foundation/evo-nexus.

    545 GitHub stars~590 tokensUpdated 5 mo ago
    Backend & APIsAuto-check passed
  • Integrate PayRam into an EXISTING app using the recommended top-up wallet pattern — credit crypto payments to a user's in-app wallet balance first, then debit invoices from that balance.

    158 GitHub stars~3k tokensUpdated 2 days ago
    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

Questions about Attio Reference Architecture

What does Attio Reference Architecture do?

Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership. Attio Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design a production Attio integration architecture with tenant-bound credentials, schema discovery, queued writes, verified webhooks, idempotency, reconciliation, and rollback ownership.

When should I use Attio Reference Architecture?

Attio Reference Architecture fits situations like: reviewing a multi-workspace Attio service; with Attio architecture; design Attio integration; attio system design.

How do I install Attio Reference Architecture in Claude Code?

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

How do I install Attio Reference Architecture in Codex?

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

Can I use Attio Reference Architecture 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 attio-reference-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/attio-reference-architecture, .gemini/skills/attio-reference-architecture, .github/skills/attio-reference-architecture and .opencode/skills/attio-reference-architecture in your project.

What does Attio Reference Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Attio Reference Architecture is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep, WebFetch, Write, Edit. Compatibility (from SKILL.md): Designed for Claude Code.

Does Attio Reference Architecture access the network?

SKILL.md names 1 domain. As links in the text: docs.attio.com. This is read from the text; nothing was executed.

Is Attio Reference Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Attio Reference Architecture use?

Attio Reference Architecture 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 Attio Reference Architecture use?

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

What are the alternatives to Attio Reference Architecture?

Skills that share tags, products or a category with Attio Reference Architecture: Pp Square (mvanhorn/printing-press-library, 2.1k stars), Plaid Fintech (sickn33/agentic-awesome-skills, 47k stars), Pakistan Payments Stack (sickn33/agentic-awesome-skills, 47k stars) and Signals (alsk1992/CloddsBot, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Attio Reference Architecture?

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