Generated banner for Scribe
Generated logo for Scribe

Scribe

AnthropicOfficialCreated by ZoomDistributed by Anthropic

  • Skill
  • Tool integration
  • Automation and integrations
  • MIT
  • No issues found

From the author

Reference skill for Zoom AI Services Scribe. Use after routing to a transcription workflow when handling uploaded or stored media, Build-platform JWT auth, fast mode transcription, batch jobs, or transcript pipeline design.
— the description by Zoom

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Scribe is a Zoom AI service providing transcription capabilities for uploaded or stored media. It supports both synchronous fast-mode transcription for individual files and asynchronous batch processing for larger archives. The skill covers authentication via Build-platform JWTs, API endpoint usage, webhook integration for status updates, and architectural patterns for handling media transcription pipelines.

What it does

  • Provides documentation for synchronous transcription of single media files.
  • Details asynchronous batch job submission and management.
  • Explains Build-platform JWT generation and credential handling.
  • Outlines webhook integration for receiving batch job status notifications.
  • Offers guidance on managing media inputs and transcript outputs via S3.
  • Provides API reference for managing transcription jobs and file results.

When to use it

  • When you need to transcribe stored audio or video files.
  • When implementing batch processing for large sets of media files.
  • When building an ETL pipeline to store transcripts in a database.
  • When you need to integrate Zoom transcription into custom applications using JWT authentication.

Advantages

  • Supports both synchronous and asynchronous processing modes.
  • Enables automated transcription workflows for stored media.
  • Provides structured API endpoints for job lifecycle management.
  • Allows for webhook-driven status tracking for batch operations.

Usage examples

“How do I perform a synchronous transcription of a single audio file?”
The agent provides the endpoint for POST /aiservices/scribe/transcribe and explains the required file and configuration parameters.
“What are the steps to submit a batch transcription job?”
The agent outlines the process of using POST /aiservices/scribe/jobs with S3 source URIs and configuring the necessary output and notification settings.
“How do I authenticate my requests to the Scribe API?”
The agent explains the requirement for generating an HS256 JWT using the Build-platform API key and secret.
“How can I track the status of a batch transcription job?”
The agent describes using the GET /aiservices/scribe/jobs/{jobId} endpoint or configuring a webhook URL for status notifications.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/anthropics/scribe/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip scribe.zip -d .agents/skills

Documentation by Zoom

Zoom AI Services Scribe

Background reference for Zoom AI Services Scribe across:

  • synchronous single-file transcription (POST /aiservices/scribe/transcribe)

  • asynchronous batch jobs (/aiservices/scribe/jobs*)

  • browser microphone pseudo-streaming via repeated short file uploads

  • webhook-driven batch status updates

  • Build-platform JWT generation and credential handling

Official docs:

Routing Guardrail

  • If the user needs uploaded or stored media transcribed into text, route here first.

  • If the user needs live meeting media without file-based upload/batch jobs, route to ../rtms/SKILL.md.

  • If the user needs Zoom REST API inventory for AI Services paths, chain ../rest-api/SKILL.md.

  • If the user needs webhook signature patterns or generic HMAC receiver hardening, optionally chain ../webhooks/SKILL.md.

  1. concepts/auth-and-processing-modes.md

  2. scenarios/high-level-scenarios.md

  3. examples/fast-mode-node.md

  4. examples/batch-webhook-pipeline.md

  5. references/api-reference.md

  6. references/environment-variables.md

  7. references/samples-validation.md

  8. references/versioning-and-drift.md

  9. troubleshooting/common-drift-and-breaks.md

  10. RUNBOOK.md

Core Workflow

  1. Get Build-platform credentials and generate an HS256 JWT.

  2. Choose fast mode for one short file or batch mode for stored archives / large sets.

  3. Submit the transcription request.

  4. For batch jobs, poll job/file status or receive webhook notifications.

  5. Persist and post-process transcript JSON.

Hosted Fast-Mode Guardrail

  • The formal fast-mode API limits are 100 MB and 2 hours, but hosted browser flows can still time out before the upstream response returns.

  • Current deployed-sample observations:

    • ~17.2 MB MP4 completed in about 26s

    • ~38.6 MB MP4 completed in about 26-37s

    • ~59.2 MB MP4 completed in about 32-34s on the backend

    • some ~59.2 MB browser requests still surfaced as frontend 504 while backend logs later showed 200

  • Treat frontend 504 plus backend 200 as a browser/edge timeout race, not an automatic transcription failure.

  • For hosted UIs, prefer an async request/polling wrapper for fast mode instead of holding the browser open for the full upstream response.

  • For larger or less predictable media, prefer batch mode even when the file is still within the formal fast-mode size limit.

Browser Microphone Pattern

  • scribe does not expose a documented real-time streaming API surface.

  • If you want a browser microphone experience, use pseudo-streaming:

    1. capture microphone audio in short chunks

    2. upload each chunk through the async fast-mode wrapper

    3. poll for completion

    4. append chunk transcripts in sequence

  • Recommended starting cadence:

    • chunk size: 5 seconds

    • acceptable range: 5-10 seconds

    • in-flight chunk requests: 2-3

  • This is a practical UI pattern for incremental transcript updates, not a substitute for rtms.

  • Treat this as a fallback demo pattern, not the preferred production architecture.

  • It adds repeated upload overhead, chunk-boundary drift, browser codec/container variability, and transcript stitching complexity.

  • If the user asks for actual live stream ingestion, low-latency continuous media, or server-push media transport, route to ../rtms/SKILL.md instead.

Endpoint Surface

ModeMethodPathUse
FastPOST/aiservices/scribe/transcribeSynchronous transcription for one file
BatchPOST/aiservices/scribe/jobsSubmit asynchronous batch job
BatchGET/aiservices/scribe/jobsList jobs
BatchGET/aiservices/scribe/jobs/{jobId}Inspect job summary/state
BatchDELETE/aiservices/scribe/jobs/{jobId}Cancel queued/processing job
BatchGET/aiservices/scribe/jobs/{jobId}/filesInspect per-file results

High-Level Scenarios

  • On-demand clip transcription after a user uploads one recording.

  • Batch transcription of stored S3 call archives.

  • Webhook-driven ETL pipeline that writes transcripts to your database/search index.

  • Re-transcription of Zoom-managed recordings after exporting them to your own storage.

  • Offline compliance or QA workflows that need timestamps, channel separation, and speaker hints.

Chaining

  • Stored Zoom recordings -> ../rest-api/SKILL.md + scribe

  • Webhook verification hardening -> ../webhooks/SKILL.md

  • Real-time live transcript/media -> ../rtms/SKILL.md

  • Cross-product routing -> ../general/SKILL.md

Operations

  • RUNBOOK.md - 5-minute preflight and debugging checklist.

Files

references/versioning-and-drift.md

Versioning and Drift

Naming Drift in Docs

The current Zoom docs are inconsistent about credential naming:

  • AI Services auth page uses API key / API secret.

  • Build-platform credentials page uses SDK key / SDK secret.

  • Quickstart code uses ZOOM_API_KEY / ZOOM_API_SECRET.

Treat these as a portal/documentation naming drift issue and verify the current credential labels in the Zoom developer UI before changing production code.

Product Positioning Drift

Scribe sits under AI Services, but related Zoom products may point users toward:

  • RTMS for live meeting streams

  • Meeting SDK Linux bots for visible in-meeting capture

  • AI Companion / REST APIs for Zoom-generated summaries and transcripts

  • blog or marketing material that frames Scribe inside broader speech/insights workflows

Keep the guardrail clear:

  • scribe = file/storage transcription service

  • rtms = live media stream ingestion

  • Meeting SDK Linux = participant bot capture / raw recording

Workflow-Claim Drift

Some AI Services and Scribe blog material frames Scribe inside broader voice-insights workflows such as:

  • post-call summaries

  • ticket enrichment

  • compliance logging

  • searchable archives

  • customer-support QA pipelines

  • sentiment or keyword-driven downstream analytics

These are valid architectural use cases, but they do not expand the current documented Scribe endpoint surface.

Implementation rule:

  • use scribe for transcript generation

  • use your own downstream pipeline for sentiment, classification, QA scoring, or summarization

  • do not infer undocumented real-time or analytics endpoints from blog phrasing alone

API Surface Drift Watchpoints

Watch for changes in:

  • storage providers beyond S3

  • request field names in config

  • webhook signature header conventions

  • response summary/file schemas

  • language / output-format support

Review Trigger

Re-review this skill when:

  • api-hub/ai-services/methods/endpoints.json changes

  • AI Services docs rename Build/API credentials again

  • quickstart sample changes webhook or upload patterns

Requirements and compatibility

Written for: Claude Code, Claude apps

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Claude Code frontmatter, Needs Node.js

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Zoom
Publisher
Anthropic (Official)
Distributed by
Anthropic
Source
anthropics/knowledge-work-plugins · partner-built/zoom-plugin/skills/scribe · commit e050c2e
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from partner-built/zoom-plugin/LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Zoom or Anthropic.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download scribe.zip