Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

attio-common-errors

/attio-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.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

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.

Wyzwalacze z opisu

Attio errorAttio request faileddebug Attio API

Argumenty

/attio-common-errors [repository-path] [status-or-error-code]
Oryginalny opis (EN)

Diagnose Attio REST API failures from status, structured error fields, endpoint contract, and request context without exposing customer data. Use when an Attio request returns 400, 401, 403, 404, 409, 422, 429, or 5xx. Trigger with "Attio error", "Attio request failed", or "debug Attio API".

Jak działa

  1. Overview
  2. Prerequisites
  3. Tool Discipline
  4. Current Contract
  5. Authentication
  6. Instructions
  7. Approval Boundaries
  8. Decision Table
  9. Output
  10. Error Handling
Sekcje z nagłówków SKILL.md, w oryginale · 86 linii, 545 słów
Podgląd SKILL.md
---
name: attio-common-errors
description: >-
  Diagnose Attio REST API failures from status, structured error fields, endpoint contract, and request context without exposing customer data. Use when an Attio request returns 400, 401, 403, 404, 409, 422, 429, or 5xx. Trigger with "Attio error", "Attio request failed", or "debug Attio API".
argument-hint: "[repository-path] [status-or-error-code]"
allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit
version: 1.8.0
author: Jeremy Longshore <jeremy@intentsolutions.io>
license: MIT
tags:
- saas
- attio
- troubleshooting
model: inherit
effort: medium
compatibility: Designed for Claude Code
---
# Attio Error Triage

## Overview

This skill classifies an Attio failure before changing code or credentials. It preserves the response's structured fields while keeping tokens and CRM values out of diagnostics.

## Prerequisites

- The HTTP method, path template, status, and redacted response body
- The endpoint's documented required scopes
- The request's pagination mode and mutation semantics
- A correlation or application request identifier when available

## Tool Discipline

Use `Read`, `Glob`, and `Grep` to locate the caller, response parser, retry policy, and logs. Use `WebFetch` only for current official Attio documentation. Use `Write` or `Edit` only after the failing contract and safe verification path are known.

## Current Contract

Attio error responses can include `status_code`, `type`, `code`, and `message`. Diagnose from observed fields instead of inventing a fixed code list; endpoint references remain authoritative for request shape and scopes.

## Authentication

Confirm that a Bearer token exists at runtime and belongs to the intended workspace. For 401, rotate or replace the invalid credential; for 403, compare granted scopes with the endpoint's required scopes before requesting any change.

## Instructions

1. Capture method, path template, status, response content type, and redacted structured error fields.
2. Reconcile the request with the exact endpoint reference, including path slug versus UUID and body envelope.
3. Classify authentication, authorization, validation, uniqueness, not-found, throttling, or provider failure.
4. For 429, parse `Retry-After` as an HTTP date and retry only after the indicated time.
5. For ambiguous 5xx failures, preserve a minimal reproduction and check Attio status before changing business logic.
6. Apply the smallest correction and repeat the same bounded request.

## Approval Boundaries

Do not broaden scopes, rotate a shared production credential, replay an ambiguous mutation, or expose customer payloads while troubleshooting without the responsible owner and a recovery plan.

## Decision Table

| Signal | Likely class | Safe next check |
|---|---|---|
| 400 or 422 | Shape or attribute-value validation | Compare body and attribute type with endpoint docs. |
| 401 | Missing or invalid token | Inspect credential injection without printing the token. |
| 403 | Insufficient scope | Compare exact required scopes. |
| 404 | Wrong resource identifier | Resolve current object, list, record, or entry ID. |
| 409 | Uniqueness conflict | Inspect the documented uniqueness boundary. |
| 429 | Global or score-based throttle | Honor `Retry-After`; simplify expensive queries. |
| 5xx | Provider or transient failure | Bound retries and retain redacted evidence. |

## Output

Return a redacted failure fingerprint, diagnosis, evidence, minimal correction, replay result, and any remaining uncertainty.

## Error Handling

| Condition | Response |
|---|---|
| Response is not JSON | Preserve status and content type; do not force JSON parsing. |
| Token appears in evidence | Stop and redact before storing or sharing it. |
| Retry repeats a permanent 4xx | Stop retrying and fix the request contract. |
| Resource identity is uncertain | Resolve it with a read-only discovery request. |

## Examples

Input:

```text
method=POST; path=/v2/objects/companies/records/query; status=403; code=forbidden
```

Expected handoff:

```text
class=authorization; missing-scope=confirmed-from-endpoint; replay=pass
```

This result ties the correction to endpoint evidence and a safe replay.

## Resources

- [Skill-specific official documentation](references/official-docs.md)
- [Authentication](https://docs.attio.com/rest-api/guides/authentication)
- [Rate limiting](https://docs.attio.com/rest-api/guides/rate-limiting)
- [REST API overview](https://docs.attio.com/rest-api/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-common-errors.

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 f645135557a9 (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-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.
  • 100attio-install-auth
    Dobiera i konfiguruje uwierzytelnianie Attio REST dla jednego lub wielu workspace'ów (OAuth), z minimalnymi uprawnieniami i weryfikacją tylko do odczytu.
  • 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.
  • 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.
  • 85taste-attio
    Odwzorowuje estetykę, typografię, tokeny kolorów i komponenty serwisu attio.com przy budowie stron i interfejsów.
  • 90attio-setup
    Konfiguruje Attio dla GTM w B2B SaaS: programowalne CRM, obiekty niestandardowe, automatyzacja przepływów, integracja wzbogacania danych i migracja z HubSpot lub Salesforce.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.