본문으로 건너뛰기
cccskills
무료GitHub에 공개

attio-common-errors

Diagnose Attio REST API failures using response status, structured error details, and endpoint documentation. Identify authentication, permission, validation, and rate-limit problems, then apply a minimal correction and verify it while keeping tokens and customer data out of diagnostic records.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

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".

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

  • Investigate 401 and 403 authentication or permission errors
  • Check request formats behind 400 and 422 errors
  • Review retry handling for 429 responses
  • Record 5xx failures without exposing customer data

포함된 파일(2)

  • SKILL.md4.4 KB
  • references/official-docs.md2.1 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

SignalLikely classSafe next check
400 or 422Shape or attribute-value validationCompare body and attribute type with endpoint docs.
401Missing or invalid tokenInspect credential injection without printing the token.
403Insufficient scopeCompare exact required scopes.
404Wrong resource identifierResolve current object, list, record, or entry ID.
409Uniqueness conflictInspect the documented uniqueness boundary.
429Global or score-based throttleHonor Retry-After; simplify expensive queries.
5xxProvider or transient failureBound retries and retain redacted evidence.

Output

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

Error Handling

ConditionResponse
Response is not JSONPreserve status and content type; do not force JSON parsing.
Token appears in evidenceStop and redact before storing or sharing it.
Retry repeats a permanent 4xxStop retrying and fix the request contract.
Resource identity is uncertainResolve it with a read-only discovery request.

Examples

Input:

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

Expected handoff:

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

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

Resources

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Add a synthetic-data CI gate for customer-owned Abridge integration code. Test consent handling, note-review handoffs, redaction, and rollback behavior with mocked vendor boundaries, without connecting CI to a live Abridge or EHR tenant.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Adding regression checks to an Abridge integration repository
  • Testing consent and note-release handling
  • Checking logs for sensitive data exposure
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

Triage Abridge recording, note review, Epic handoff, and access problems using observed symptoms and approved guidance. Identify the affected workflow stage, organize a minimal timeline, and prepare a redacted escalation record for the responsible team.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Separate recording problems from upload failures
  • Investigate note creation delays and editor issues
  • Identify the responsible team for Epic handoff failures
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

Map and review an Abridge clinical documentation workflow from consent and recording through draft review, evidence checks, edits, and final disposition. Keep clinician approval explicit, identify failure exits, and separate verified facts from tenant-specific details and pending approvals.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Map a clinical note workflow for a care setting
  • Check where consent and patient identity are verified
  • Review draft notes against linked evidence before sign-off
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

Audit how clinician-reviewed Abridge note sections map into Epic templates and downstream workflows. Use approved test records to document destinations, exceptions, evidence, rollback steps, and a go or no-go decision for a specific environment.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking Abridge note section mappings to Epic templates
  • Auditing a department’s approved documentation handoff
  • Preparing test evidence and a go or no-go decision
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

Review Abridge adoption and workflow value using local usage records, clinician feedback, and verified contract costs. Build an evidence based decision table covering adoption, quality, support burden, and options to expand, hold, or improve the rollout.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Reviewing adoption after an Abridge rollout
  • Preparing evidence for a renewal decision
  • Comparing workflow outcomes across care settings
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

Prepare a bounded support bundle for an Abridge issue using allowlisted operational details such as versions, coarse timestamps, and correlation references. Exclude recordings, transcripts, patient identifiers, credentials, and unrestricted logs, then document redactions and review details.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Preparing reviewed evidence for an Abridge support case
  • Documenting redactions and excluded data
  • Collecting approved operational details for an incident
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 25일 업데이트

jeremylongshore의 스킬 모두 보기

이 스킬의 문제 신고