Agent skill · software engineering · jeremylongshore
assemblyai-sdk-patterns
Analyze and design a typed AssemblyAI adapter that isolates SDK drift, regional routing, polling, and streaming lifecycles. Use when integrating an official SDK. Trigger with "AssemblyAI SDK pattern", "AssemblyAI adapter", or "wrap AssemblyAI".
Why this skill is useful
Adds production-ready TypeScript and Python SDK patterns for AssemblyAI, including error handling and client initialization scripts that enhance integration capabilities.
What it needs
Requires assemblyai installed locally. Requires assemblyai account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
AssemblyAI Typed Adapter Boundary Overview Design a narrow application-owned boundary around the current SDK. Keep data, credentials, region, retries, spend, and destructive state separately governed. Prerequisites The target repository or integration path and the requested operator outcome. The AssemblyAI project, environment, region, data classification, and accountable owner. Current first-party documentation plus credentials only for a narrowly approved live check. Current Contract Pre-recorded jobs, Streaming v3 sessions, temporary-token issuance, webhooks, and LLM Gateway requests have different lifecycles. Keep vendor objects behind a narrow application-owned port. New code must not expose legacy LeMUR methods or Streaming v2 service names. Authentication For live work, inject ASSEMBLYAIAPIKEY from an approved secret manager and send the raw value only in the AssemblyAI Authorization header to the configured first-party host. Never print, commit, place in a URL, or expose it to an untrusted client. Callback secrets and temporary streaming tokens are separate credentials. Instructions 1. Inventory direct SDK imports and classify each surface. 2. Define narrow request, result, and stable application-error types. 3. Centralize immutable region, authentication, deadlines, and retry policy. 4. Separate job submission from completion retrieval. 5. Model streaming connect, begin, turns, termination, and confirmation. 6. Pin the SDK and prove the boundary with contract fixtures. Tool Discipline Use Read, Glob, and Grep to inspect repository code, configuration, fixtures, and evidence. Use Write and Edit only for approved implementation or documentation changes. Do not call AssemblyAI, upload audio, open a streaming session, mint a token, replay a callback, deploy, rotate a key, or delete a transcript merely because this skill was invoked. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/assemblyai-sdk-patterns