Menu
Run the full local verification gate for the assembly CLI (the same checks CI runs). Use before pushing or opening a PR.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use the AssemblyAI CLI (`assembly`) from the command line โ transcribe audio/video files, URLs, and YouTube/podcast links; stream live real-time transcription from a mic/file/system audio; run full-duplex voice agents; query the LLM Gateway over transcripts; browse transcript and streaming-session history; sign in and manage account balance, usage, rate limits, API keys, and audit logs; scaffold a starter app (init); diagnose setup (doctor); and set up your coding agent's AssemblyAI docs MCP + skills (setup). Use whenever an agent is invoking the `assembly` command.
Prepare an assembly CLI release โ confirm main is green, then tag (locally or via the manual workflow) to trigger the bottle pipeline. Use when cutting a new release.
Plan a new assembly CLI feature the way this repo does โ drive the superpowers planning skill, then persist the spec + plan into docs/superpowers/ under this repo's naming and verification conventions. Use before building anything non-trivial.
| name | check |
| description | Run the full local verification gate for the assembly CLI (the same checks CI runs). Use before pushing or opening a PR. |
| disable-model-invocation | true |
Run the project's canonical verification gate and report the result.
Run the full gate:
./scripts/check.sh
This runs, in order: uv lock --check โ ruff check โ ruff format --check โ mypy (src + tests) โ pyright (src strict, then tests) โ vulture (dead code) โ deptry (dependency hygiene) โ lint-imports (architecture contracts) โ xenon (cyclomatic complexity, max grade B / project avg A) โ swiftlint + swift compile (macOS only) โ markdownlint (excludes generated docs/) โ prettier (init template JS/CSS) โ shellcheck scripts/check.sh โ generated --show-code compile gate โ init template contract gate โ pytest with a 90% branch-coverage gate (--cov-fail-under=90, excluding e2e/install markers) โ diff-cover (100% patch coverage vs origin/main) โ a "no new escape hatches" diff gate โ uv build + twine check --strict. Everything Python runs through uv run against the locked environment.
Heads-up on the stages ruff+mypy don't cover: vulture flags unused code, deptry flags unused/missing/misplaced dependencies, lint-imports enforces the import-architecture contracts in .importlinter, and xenon fails any function over cyclomatic-complexity grade B (CC > 10). These are the ones that most often surprise an otherwise-clean change.
If anything fails, fix it and re-run ./scripts/check.sh until it passes. Do not claim success until the script prints All checks passed.
Run these only when relevant โ they are slow and/or need credentials:
uv run pytest -m e2e # real-API end-to-end; needs ASSEMBLYAI_API_KEY + kokoro
shellcheck, prettier, swiftlint/swiftc โ self-skip with a notice when not installed (CI still runs them); that's expected, not a failure. swiftlint/swiftc also no-op off macOS.diff-cover and the escape-hatch gate self-skip when origin/main isn't present (e.g. a shallow branch-only clone); CI provides the base ref.