Agent skill · software engineering · jeremylongshore

assemblyai-local-dev-loop

Build an AssemblyAI local loop with synthetic fixtures, recorded contracts, and an optional bounded live lane. Use when developing without exposing audio or uncontrolled credits. Trigger with "AssemblyAI local dev" or "mock AssemblyAI".

Why this skill is useful

Adds specific scripts and configurations for setting up a local development environment with AssemblyAI that are not commonly found in public documentation.

What it needs

Requires node 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 Deterministic Local Development Overview Build an AssemblyAI local loop with synthetic fixtures, recorded contracts, and an optional bounded live lane. Treat live audio, transcript content, credentials, spend, and destructive state as separately governed boundaries. 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 Ordinary development stays offline. Fixtures model REST job states, Streaming v3 messages, both webhook families, LLM Gateway outputs, throttling, duplicates, and termination. A public tunnel and live API call are explicit exposure and cost boundaries. 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. Map the adapter surfaces actually used. 2. Create synthetic audio and content-free response fixtures. 3. Inject a fake clock, deterministic jitter, and bounded queues. 4. Cover delayed polling, 429, duplicates, malformed events, and disconnects. 5. Protect live tests behind a separate flag and secret context. 6. Review recorded-contract diffs against current first-party schemas. 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-local-dev-loop--93a9f7

View the source on GitHub

Browse the @skills marketplace