Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/abridge-sdk-patterns

@820dfc8
Run it yourself

Implement a narrow customer-owned adapter around an approved Abridge tenant interface without claiming a public SDK. Use when coding against vendor-issued integration specifications. Trigger with "build the Abridge adapter".

Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/abridge-sdk-patterns

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈62 tokens for metadata: the name and description. ≈1k when used: this file. ≈426 more on demand in 1 file.

Description uses 3.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈247 characters, or 3.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Abridge Private-Contract Adapter Patterns

Overview

Keep vendor-specific transport behind a typed port whose schema, authentication, errors, timeouts, and retry rules are pinned to the private contract revision. Make unsupported behavior fail closed and keep clinical review outside the adapter.

Prerequisites

  • The authorized Abridge environment, clinical owner, and health-system policy set
  • Current tenant-specific implementation evidence for every private interface in scope
  • Synthetic data or the organization's formally approved test-record procedure

Tool Discipline

Use Read, Glob, and Grep to inspect repository configuration, adapters, tests, policies, and existing evidence. Use WebFetch only for current official Abridge, HHS, or named EHR documentation. Use Write or Edit only after confirming scope, environment, owners, patient-data boundary, and approval state. These tools do not confer access to Abridge, an EHR, or a clinical record; return exact operator steps or an approval-gated handoff for live actions.

Current Contract

  • The cited public Abridge sources describe product workflows, not a general public SDK package or stable REST surface.
  • Partner-issued specifications may be implemented only for the authorized tenant and cannot be generalized without evidence.
  • Clinical content, credentials, and tenant identifiers must not appear in logs or test fixtures.

Authentication

Use only the health system's provisioned Abridge application access, SSO, administrative role, or tenant-specific partner authentication documented for the approved environment. Do not infer public API credentials, reuse production secrets in tests, or expose tokens and session material. Verify identity owner, least privilege, environment binding, storage, rotation, and revocation before any authenticated action.

Instructions

  1. Verify the contract owner, revision, environment, authentication protocol, schemas, delivery semantics, and support path.
  2. Use Read, Glob, and Grep to inspect existing ports, adapters, configuration, error types, and tests.
  3. Define typed request and response envelopes with strict parsing, explicit unknown-field behavior, redacted errors, and bounded timeouts.
  4. Implement retries only for contract-authorized idempotent operations; expose manual reconciliation for ambiguous outcomes.
  5. Use Write or Edit to add the adapter, synthetic contract fixtures, version negotiation, and rollback path.
  6. Use WebFetch only to align user-facing workflow language with official Abridge guidance.

Approval Boundaries

Do not guess endpoints, credentials, headers, scopes, event names, or response fields. Do not publish private contract material in the repository.

Output

Return contract revision, implemented operations, auth boundary, parser policy, retry classes, test coverage, logging exclusions, and unsupported operations. Separate verified facts, tenant-specific evidence, assumptions, and actions still awaiting approval.

Error Handling

Condition Response
Contract revision is missing Refuse implementation.
Response violates schema Quarantine the payload metadata and escalate without logging content.
Outcome is ambiguous Do not retry a possible clinical write automatically.

Example

The example is a redacted operational receipt, not patient data or proof of vendor certification.

contract=vendor-ICD-r9; operations=3; fixtures=synthetic; unknown-fields=reject; retries=idempotent-only; private-docs-committed=no

Resources

Read the source map before changing a workflow. Recheck tenant-specific implementation evidence for every interface or capability that public documentation does not define.

Next Steps

Revalidate the evidence date and tenant-specific authority before repeating this workflow in another environment, cohort, care setting, or integration mode.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill provides secure patterns for building adapters to the Abridge platform, focusing on HIPAA compliance and credential safety. It emphasizes using synthetic data, strictly avoiding hardcoded secrets, and following official documentation from trusted sources.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago
What it can do
Reads files Network Edits files
Modelinherit
argument-hint
[interface-contract] [language]
version
1.5.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
All 6 allowed tools
ReadGlobGrepWebFetchWriteEdit
Other metadata
tags
[
  "saas",
  "abridge",
  "adapter",
  "private-contract",
  "reliability"
]
model
inherit
effort
high
compatibility
Designed for Claude Code; live work requires an authorized Abridge tenant, approved test data, and health-system change authority

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/abridge-sdk-patterns