Agent skill · data analytics · jeremylongshore
abridge-common-errors
Diagnose and fix common Abridge clinical AI integration errors.
Why this skill is useful
Adds detailed troubleshooting scripts and specific error handling procedures for Abridge clinical AI integration that are not publicly documented.
What it needs
Requires bash installed locally. Requires abridge account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Abridge Common Errors Overview Comprehensive troubleshooting guide for Abridge clinical documentation integration. Covers authentication failures, EHR connectivity, audio streaming, note generation, and FHIR push errors. Prerequisites Collect a timestamp, sanitized request or session ID, the affected sandbox or production environment, and the relevant HTTP status before investigation. Use a permitted support environment and redact patient names, MRNs, dates of birth, transcripts, and authorization values from every log or ticket. Instructions Start with the error code or symptom table, then reproduce only with synthetic data where possible. Check credentials and the FHIR endpoint before retrying a session; validate audio format before changing transcription logic. Run the diagnostic script with secrets supplied by the environment, preserve only its status codes and request identifiers, and escalate with the smallest redacted reproduction when the targeted fix does not resolve the fault. Error Reference Authentication & Authorization Errors Code Error Root Cause Fix ------ ------- ----------- ----- 401 INVALIDCREDENTIALS Expired or wrong partner secret Rotate credentials in Abridge Partner Portal 401 TOKENEXPIRED SMART on FHIR token expired Refresh token before 60-min expiry 403 ORGNOTPROVISIONED orgid not activated Contact Abridge sales engineer 403 SPECIALTYNOTLICENSED Specialty not in contract Check licensed specialties in Partner Portal 403 PROVIDERNOTENROLLED Provider not onboarded Complete provider enrollment in Abridge admin Session & Encounter Errors Code Error Root Cause Fix ------ ------- ----------- ----- 409 SESSIONALREADYACTIVE Duplicate session for same encounter Reuse existing sessionid 422 INVALIDSPECIALTY Unsupported specialty code Use codes from /specialties endpoint 422 PATIENTNOTFOUND Patient ID not in EHR context Verify FHIR Patient resource exists 408 SESSIONTIMEOUT Session idle > 30 minutes Create new session; old ones auto-expire 500 SESSIONCO …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/abridge-common-errors