debug-zoom-integration
anthropics/knowledge-work-plugins
Quickly isolate which layer of your Zoom implementation is broken—auth, webhooks, SDK, or media.
What is debug-zoom-integration?
Diagnostic skill for troubleshooting failed Zoom integrations. Use when authentication, webhooks, SDK joins, MCP transport, or real-time media workflows are failing to identify the root cause before proposing a fix.
- Triages failures across auth, request construction, SDK initialization, media behavior, and MCP transport layers
- Requests and analyzes error text, platform details, payloads, and reproducibility to narrow scope
- Routes to specialized Zoom skills (OAuth, REST API, webhooks, meeting/video SDKs, RTMS, MCP) based on diagnosis
- Ranks hypotheses by likelihood and provides a short fix plan
- Suggests verification steps to confirm the root cause
How to install debug-zoom-integration
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill debug-zoom-integrationHow to use debug-zoom-integration
- 1.Describe the failure: exact error message, platform, SDK/runtime version, and when it occurs
- 2.Provide a sample request, payload, or event that failed
- 3.Clarify what worked before (if applicable) and whether the issue is reproducible
- 4.Review the skill's triage order and ranked hypotheses for your layer
- 5.Follow the suggested fix plan and verification steps
- 6.If needed, install and use the referenced specialized skill (oauth, webhooks, meeting-sdk, etc.)
Use cases
- A Zoom OAuth flow is returning 401 errors and you need to determine if it's app config, token refresh, or scope mismatch
- Webhook events aren't firing and you need to check if the issue is registration, signature verification, or event routing
- Meeting SDK join fails intermittently on certain platforms and you need to isolate SDK vs. session state vs. network issues
- Real-time media stream is choppy or dropping and you need to distinguish between RTMS configuration, codec negotiation, or network conditions
- MCP transport to Zoom is timing out and you need to verify capability assumptions and request formatting
- Backend engineers debugging Zoom API integrations
- Full-stack developers troubleshooting SDK implementations
- DevOps/SRE teams investigating production Zoom failures
- Integration engineers isolating cross-layer issues before escalation
debug-zoom-integration FAQ
Use this when you're unsure which layer is broken. It triages quickly to narrow scope. If you already know it's an auth issue, go directly to the oauth skill.
Request platform details, SDK version, a minimal reproducible example, and what changed recently. The triage order helps narrow scope even with incomplete info.
No—it diagnoses and routes. Once you identify the layer, install the relevant specialized skill (webhooks, meeting-sdk, video-sdk, rtms, or zoom-mcp) to implement the fix.
Test the same request/scenario multiple times. Intermittent failures often point to race conditions, rate limits, or network flakiness; reproducible ones suggest config or logic errors.
Meeting SDK handles join/leave and session control; Video SDK handles real-time media streams. The triage order helps distinguish them based on what's failing.
Full instructions (SKILL.md)
Source of truth, from anthropics/knowledge-work-plugins.
name: debug-zoom-integration description: Debug broken Zoom implementations quickly. Use when auth, webhooks, SDK joins, MCP transport, or real-time media workflows are failing and you need to isolate the layer before proposing a fix. user-invocable: false
Debug Zoom Integration
Use this skill when the user already built something and it is failing.
Triage Order
- Auth and app configuration
- Request construction or event verification
- SDK initialization or platform mismatch
- Media/session behavior
- MCP transport and capability assumptions
Evidence To Request
- Exact error text
- Platform and SDK/runtime
- Relevant request or payload sample
- What worked versus what failed
- Whether the issue is reproducible or intermittent
Reference Routing
- oauth
- rest-api
- webhooks
- meeting-sdk
- video-sdk
- rtms
- zoom-mcp
Output
- Most likely failing layer
- Ranked hypotheses
- Short fix plan
- Verification steps
Related skills
More from anthropics/knowledge-work-plugins and the wider catalog.
deploy-checklist
Pre-deployment verification checklist to catch issues before shipping to production.
design-critique
Get structured design feedback on usability, hierarchy, and consistency.
design-handoff
Generate comprehensive developer handoff specs from designs with layout, tokens, states, and accessibility details.
design-mcp-workflow
Decide whether Zoom MCP fits your task and plan tool-based AI workflows.
design-system
Audit, document, or extend your design system with consistency checks and component documentation.
digest
Generate daily or weekly digests of activity across all connected sources to catch up on mentions, action items, and decisions.