[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ESFNB43QBAAPHHR0PGRHSY":3,"skill-same:01M7ESFNB43QBAAPHHR0PGRHSY":162},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":48,"ownerDescription":6,"updatedAt":49,"install":50,"resources":63},"01M7ESFNB43QBAAPHHR0PGRHSY","zoom-apps-sdk",null,"Reference skill for Zoom Apps SDK. Use after routing to an in-client app workflow when building web apps that run inside Zoom meetings, webinars, the main client, or Zoom Phone.","TanNhatCMS\u002Fjarvis","TanNhatCMS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113796420?v=4","01M753MV17KG5CD3152G3WQEQY","KietNT","01M7EKEDYVYQ6PWVJJMZ911VMX",0,"MIT","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: zoom-apps-sdk\ndescription: Reference skill for Zoom Apps SDK. Use after routing to an in-client app workflow when building web apps that run inside Zoom meetings, webinars, the main client, or Zoom Phone.\nuser-invocable: false\ntriggers:\n  - \"zoom app\"\n  - \"in-meeting app\"\n  - \"app inside zoom\"\n  - \"zoom client app\"\n  - \"layers api\"\n  - \"immersive mode\"\n  - \"camera mode\"\n  - \"collaborate mode\"\n  - \"appssdk\"\n  - \"in-client oauth\"\n  - \"zoom mail\"\n  - \"domain allowlist\"\n  - \"domain whitelist\"\n  - \"url whitelisting\"\n  - \"blank panel\"\n  - \"runningContext\"\n  - \"zoomSdk\"\n---\n\n\u003C!-- Provenance: adapted from anthropics\u002Fknowledge-work-plugins (Apache-2.0, (c) Anthropic).\nOriginal skill: https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Ftree\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk. Changes for Muse AI: Claude\u002FCowork product refs -> Muse AI; MCP -> connector; CLAUDE.md -> MUSE.md; ${CLAUDE_PLUGIN_ROOT} -> this skill's directory; \u002Fplugin:command refs -> skill refs. -->\n\n\n# Zoom Apps SDK\n\nBackground reference for web apps that run inside the Zoom client. Prefer `choose-zoom-approach` first, then route here for Layers API, Collaborate Mode, in-client OAuth, and runtime constraints.\n\n# Zoom Apps SDK\n\nBuild web apps that run inside the Zoom client - meetings, webinars, main client, and Zoom Phone.\n\n**Official Documentation**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n**SDK Reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n**NPM Package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n\n## Quick Links\n\n**New to Zoom Apps? Follow this path:**\n\n1. **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking\n2. **[Quick Start](examples\u002Fquick-start.md)** - Complete working Express + SDK app\n3. **[Running Contexts](concepts\u002Frunning-contexts.md)** - Where your app runs (inMeeting, inMainClient, etc.)\n4. **[Zoom Apps vs Meeting SDK](concepts\u002Fmeeting-sdk-vs-zoom-apps.md)** - Stop mixing app types\n4. **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - Seamless authorization with PKCE\n5. **[API Reference](references\u002Fapis.md)** - 100+ SDK methods\n6. **Integrated Index** - see the section below in this file\n7. **[5-Minute Runbook](RUNBOOK.md)** - Preflight checks before deep debugging\n\n**Reference:**\n- **[API Reference](references\u002Fapis.md)** - All SDK methods by category\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API](references\u002Flayers-api.md)** - Immersive and camera mode rendering\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n**Having issues?**\n- App won't load in Zoom → Check [Domain Allowlist](#url-whitelisting-required) below\n- SDK errors → [Common Issues](troubleshooting\u002Fcommon-issues.md)\n- Local dev setup → [Debugging Guide](troubleshooting\u002Fdebugging.md)\n- Version upgrade → [Migration Guide](troubleshooting\u002Fmigration.md)\n- Forum-derived FAQs → [Forum Top Questions](troubleshooting\u002Fforum-top-questions.md)\n\n**Building immersive experiences?**\n- [Layers Immersive Mode](examples\u002Flayers-immersive.md) - Custom video layouts\n- [Camera Mode](examples\u002Flayers-camera.md) - Virtual camera overlays\n\n> **Need help with OAuth?** See the **[zoom-oauth](..\u002Foauth\u002FSKILL.md)** skill for authentication flows.\n\n## SDK Overview\n\nThe Zoom Apps SDK (`@zoom\u002Fappssdk`) provides JavaScript APIs for web apps running in Zoom's embedded browser:\n\n- **Context APIs** - Get meeting, user, and participant info\n- **Meeting Actions** - Share app, invite participants, open URLs\n- **Authorization** - In-Client OAuth with PKCE (no browser redirect)\n- **Layers API** - Immersive video layouts and camera mode overlays\n- **Collaborate Mode** - Shared app state across participants\n- **App Communication** - Message passing between app instances (main client \u003C-> meeting)\n- **Media Controls** - Virtual backgrounds, camera listing, recording control\n- **UI Controls** - Expand app, notifications, popout\n- **Events** - React to meeting state, participants, sharing, and more\n\n## Prerequisites\n\n- Zoom app configured as **\"Zoom App\"** type in [Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n- OAuth credentials (Client ID + Secret) with Zoom Apps scopes\n- Web application (Node.js + Express recommended)\n- **Your domain whitelisted** in Marketplace domain allowlist\n- ngrok or HTTPS tunnel for local development\n- Node.js 18+ (for the backend server)\n\n## Quick Start\n\n### Option A: NPM (Recommended for frameworks)\n\n```bash\nnpm install @zoom\u002Fappssdk\n```\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nasync function init() {\n  try {\n    const configResponse = await zoomSdk.config({\n      capabilities: [\n        'shareApp',\n        'getMeetingContext',\n        'getUserContext',\n        'openUrl'\n      ],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n    \u002F\u002F 'inMeeting' | 'inMainClient' | 'inWebinar' | 'inImmersive' | ...\n\n    const context = await zoomSdk.getMeetingContext();\n    console.log('Meeting ID:', context.meetingID);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n```\n\n### Option B: CDN (Vanilla JS)\n\n```html\n\u003Cscript src=\"https:\u002F\u002Fappssdk.zoom.us\u002Fsdk.js\">\u003C\u002Fscript>\n\n\u003Cscript>\n\u002F\u002F CRITICAL: Do NOT declare \"let zoomSdk\" - the SDK defines window.zoomSdk globally\n\u002F\u002F Using \"let zoomSdk = ...\" causes: SyntaxError: redeclaration of non-configurable global property\nlet sdk = window.zoomSdk;  \u002F\u002F Use a different variable name\n\nasync function init() {\n  try {\n    const configResponse = await sdk.config({\n      capabilities: ['shareApp', 'getMeetingContext', 'getUserContext'],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n\nfunction showDemoMode() {\n  document.body.innerHTML = '\u003Ch1>Preview Mode\u003C\u002Fh1>\u003Cp>Open this app inside Zoom to use.\u003C\u002Fp>';\n}\n\ndocument.addEventListener('DOMContentLoaded', () => {\n  init();\n  setTimeout(() => { if (!sdk) showDemoMode(); }, 3000);\n});\n\u003C\u002Fscript>\n```\n\n## Critical: Global Variable Conflict\n\nThe CDN script defines `window.zoomSdk` globally. **Do NOT redeclare it:**\n\n```javascript\n\u002F\u002F WRONG - causes SyntaxError in Zoom's embedded browser\nlet zoomSdk = null;\nzoomSdk = window.zoomSdk;\n\n\u002F\u002F CORRECT - use different variable name\nlet sdk = window.zoomSdk;\n\n\u002F\u002F ALSO CORRECT - NPM import (no conflict)\nimport zoomSdk from '@zoom\u002Fappssdk';\n```\n\nThis only applies to the CDN approach. The NPM import creates a module-scoped variable, no conflict.\n\n## Browser Preview \u002F Demo Mode\n\nThe SDK only functions inside the Zoom client. When accessed in a regular browser:\n- `window.zoomSdk` exists but `sdk.config()` throws an error\n- Always implement try\u002Fcatch with fallback UI\n- Add timeout (3 seconds) in case SDK hangs\n\n## URL Whitelisting (Required)\n\n**Your app will NOT load in Zoom unless the domain is whitelisted.**\n\n1. Go to [Zoom Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n2. Open your app -> **Feature** tab\n3. Under **Zoom App**, find **Add Allow List**\n4. Add your domain (e.g., `yourdomain.com` for production, `xxxxx.ngrok.io` for dev)\n\nWithout this, the Zoom client shows a blank panel with no error message.\n\n## OAuth Scopes (Required)\n\nCapabilities require matching OAuth scopes enabled in Marketplace:\n\n| Capability | Required Scope |\n|------------|----------------|\n| `getMeetingContext` | `zoomapp:inmeeting` |\n| `getUserContext` | `zoomapp:inmeeting` |\n| `shareApp` | `zoomapp:inmeeting` |\n| `openUrl` | `zoomapp:inmeeting` |\n| `sendAppInvitation` | `zoomapp:inmeeting` |\n| `runRenderingContext` | `zoomapp:inmeeting` |\n| `authorize` | `zoomapp:inmeeting` |\n| `getMeetingParticipants` | `zoomapp:inmeeting` |\n\n**To add scopes:** Marketplace -> Your App -> **Scopes** tab -> Add required scopes.\n\nMissing scopes = capability fails silently or throws error. Users must re-authorize if you add new scopes.\n\n## Running Contexts\n\nYour app runs in different surfaces within Zoom. The `configResponse.runningContext` tells you where:\n\n| Context | Surface | Description |\n|---------|---------|-------------|\n| `inMeeting` | Meeting sidebar | Most common. Full meeting APIs available |\n| `inMainClient` | Main client panel | Home tab. No meeting context APIs |\n| `inWebinar` | Webinar sidebar | Host\u002Fpanelist. Meeting + webinar APIs |\n| `inImmersive` | Layers API | Full-screen custom rendering |\n| `inCamera` | Camera mode | Virtual camera overlay |\n| `inCollaborate` | Collaborate mode | Shared state context |\n| `inPhone` | Zoom Phone | Phone call app |\n| `inChat` | Team Chat | Chat sidebar |\n\nSee **[Running Contexts](concepts\u002Frunning-contexts.md)** for context-specific behavior and APIs.\n\n## SDK Initialization Pattern\n\nEvery Zoom App starts with `config()`:\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nconst configResponse = await zoomSdk.config({\n  capabilities: [\n    \u002F\u002F List ALL APIs you will use\n    'getMeetingContext',\n    'getUserContext',\n    'shareApp',\n    'openUrl',\n    'authorize',\n    'onAuthorized'\n  ],\n  version: '0.16'\n});\n\n\u002F\u002F configResponse contains:\n\u002F\u002F {\n\u002F\u002F   runningContext: 'inMeeting',\n\u002F\u002F   clientVersion: '5.x.x',\n\u002F\u002F   unsupportedApis: []  \u002F\u002F APIs not supported in this client version\n\u002F\u002F }\n```\n\n**Rules:**\n1. `config()` MUST be called before any other SDK method\n2. Only capabilities listed in `config()` are available\n3. Capabilities must match OAuth scopes in Marketplace\n4. Check `unsupportedApis` for graceful degradation\n\n## In-Client OAuth (Summary)\n\nBest UX for authorization - no browser redirect:\n\n```javascript\n\u002F\u002F 1. Get code challenge from your backend\nconst { codeChallenge, state } = await fetch('\u002Fapi\u002Fauth\u002Fchallenge').then(r => r.json());\n\n\u002F\u002F 2. Trigger in-client authorization\nawait zoomSdk.authorize({ codeChallenge, state });\n\n\u002F\u002F 3. Listen for authorization result\nzoomSdk.addEventListener('onAuthorized', async (event) => {\n  const { code, state } = event;\n  \u002F\u002F 4. Send code to backend for token exchange\n  await fetch('\u002Fapi\u002Fauth\u002Ftoken', {\n    method: 'POST',\n    body: JSON.stringify({ code, state })\n  });\n});\n```\n\nSee **[In-Client OAuth Guide](examples\u002Fin-client-oauth.md)** for complete implementation.\n\n## Layers API (Summary)\n\nBuild immersive video layouts and camera overlays:\n\n```javascript\n\u002F\u002F Start immersive mode - replaces gallery view\nawait zoomSdk.runRenderingContext({ view: 'immersive' });\n\n\u002F\u002F Position participant video feeds\nawait zoomSdk.drawParticipant({\n  participantUUID: 'user-uuid',\n  x: 0, y: 0, width: 640, height: 480, zIndex: 1\n});\n\n\u002F\u002F Add overlay images\nawait zoomSdk.drawImage({\n  imageData: canvas.toDataURL(),\n  x: 0, y: 0, width: 1280, height: 720, zIndex: 0\n});\n\n\u002F\u002F Exit immersive mode\nawait zoomSdk.closeRenderingContext();\n```\n\nSee **[Layers Immersive](examples\u002Flayers-immersive.md)** and **[Camera Mode](examples\u002Flayers-camera.md)**.\n\n## Environment Variables\n\n| Variable | Description | Where to Find |\n|----------|-------------|---------------|\n| `ZOOM_APP_CLIENT_ID` | App client ID | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_CLIENT_SECRET` | App client secret | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_REDIRECT_URI` | OAuth redirect URL | Your server URL + `\u002Fauth` |\n| `SESSION_SECRET` | Cookie signing secret | Generate random string |\n| `ZOOM_HOST` | Zoom host URL | `https:\u002F\u002Fzoom.us` (or `https:\u002F\u002Fzoomgov.com`) |\n\n## Common APIs\n\n| API | Description |\n|-----|-------------|\n| `config()` | Initialize SDK, request capabilities |\n| `getMeetingContext()` | Get meeting ID, topic, status |\n| `getUserContext()` | Get user name, role, participant ID |\n| `getRunningContext()` | Get current running context |\n| `getMeetingParticipants()` | List participants |\n| `shareApp()` | Share app screen with participants |\n| `openUrl({ url })` | Open URL in external browser |\n| `sendAppInvitation()` | Invite users to open your app |\n| `authorize()` | Trigger In-Client OAuth |\n| `connect()` | Connect to other app instances |\n| `postMessage()` | Send message to connected instances |\n| `runRenderingContext()` | Start Layers API (immersive\u002Fcamera) |\n| `expandApp({ action })` | Expand\u002Fcollapse app panel |\n| `showNotification()` | Show notification in Zoom |\n\n## Complete Documentation Library\n\n### Core Concepts\n- **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking, X-Zoom-App-Context\n- **[Running Contexts](concepts\u002Frunning-contexts.md)** - All contexts, context-specific APIs, multi-instance communication\n- **[Security](concepts\u002Fsecurity.md)** - OWASP headers, CSP, cookie security, PKCE, token storage\n\n### Complete Examples\n- **[Quick Start](examples\u002Fquick-start.md)** - Hello World Express + SDK app\n- **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - PKCE authorization flow\n- **[Layers Immersive](examples\u002Flayers-immersive.md)** - Custom video layouts\n- **[Camera Mode](examples\u002Flayers-camera.md)** - Virtual camera overlays\n- **[Collaborate Mode](examples\u002Fcollaborate-mode.md)** - Shared state across participants\n- **[Guest Mode](examples\u002Fguest-mode.md)** - Unauthenticated\u002Fauthenticated\u002Fauthorized states\n- **[Breakout Rooms](examples\u002Fbreakout-rooms.md)** - Room detection and cross-room state\n- **[App Communication](examples\u002Fapp-communication.md)** - connect + postMessage between instances\n\n### Troubleshooting\n- **[Common Issues](troubleshooting\u002Fcommon-issues.md)** - Quick diagnostics and error codes\n- **[Debugging](troubleshooting\u002Fdebugging.md)** - Local dev, ngrok, browser preview\n- **[Migration](troubleshooting\u002Fmigration.md)** - SDK version upgrade notes\n\n### References\n- **[API Reference](references\u002Fapis.md)** - All 100+ SDK methods\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API Reference](references\u002Flayers-api.md)** - Drawing and rendering methods\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n## Sample Repositories\n\n### Official (by Zoom)\n\n| Repository | Type | Last Updated | Status | SDK Version |\n|-----------|------|-------------|--------|-------------|\n| [zoomapps-sample-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-sample-js) | Hello World (Vanilla JS) | Dec 2025 | Active | ^0.16.26 |\n| [zoomapps-advancedsample-react](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-advancedsample-react) | Advanced (React + Redis) | Oct 2025 | Active | 0.16.0 |\n| [zoomapps-customlayout-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-customlayout-js) | Layers API | Nov 2023 | Stale | ^0.16.8 |\n| [zoomapps-texteditor-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-texteditor-vuejs) | Collaborate (Vue + Y.js) | Oct 2023 | Stale | ^0.16.7 |\n| [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) | Serverless (Firebase) | Aug 2024 | Stale | ^0.16.21 |\n| [zoomapps-cameramode-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-cameramode-vuejs) | Camera Mode | - | - | - |\n| [zoomapps-workshop-sample](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-workshop-sample) | Workshop | - | - | - |\n\n**Recommended for new projects:** Use `@zoom\u002Fappssdk` version `^0.16.26`.\n\n### Community\n\n| Type | Repository | Description |\n|------|------------|-------------|\n| Library | [harvard-edtech\u002Fzaccl](https:\u002F\u002Fgithub.com\u002Fharvard-edtech\u002Fzaccl) | Zoom App Complete Connection Library |\n\n**Full list**: See [general\u002Freferences\u002Fcommunity-repos.md](..\u002Fgeneral\u002Freferences\u002Fcommunity-repos.md)\n\n### Learning Path\n\n1. **Start**: `zoomapps-sample-js` - Simplest, most up-to-date\n2. **Advanced**: `zoomapps-advancedsample-react` - Comprehensive (In-Client OAuth, Guest Mode, Collaborate)\n3. **Specialized**: Pick based on feature (Layers, Serverless, Camera Mode)\n\n## Critical Gotchas (From Real Development)\n\n### 1. Global Variable Conflict\nThe CDN script defines `window.zoomSdk`. Declaring `let zoomSdk` in your code causes `SyntaxError: redeclaration of non-configurable global property`. Use `let sdk = window.zoomSdk` or the NPM import.\n\n### 2. Domain Allowlist\nYour app URL **must** be in the Marketplace domain allowlist. Without it, Zoom shows a blank panel with no error. Also add `appssdk.zoom.us` and any CDN domains you use.\n\n### 3. Capabilities Must Be Listed\nOnly APIs listed in `config({ capabilities: [...] })` are available. Calling an unlisted API throws an error. This is also true for event listeners.\n\n### 4. SDK Only Works Inside Zoom\n`zoomSdk.config()` throws outside the Zoom client. Always wrap in try\u002Fcatch with browser fallback:\n```javascript\ntry { await zoomSdk.config({...}); } catch { showBrowserPreview(); }\n```\n\n### 5. ngrok URL Changes\nFree ngrok URLs change on restart. You must update 4 places in Marketplace: Home URL, Redirect URL, OAuth Allow List, Domain Allow List. Consider ngrok paid plan for stable subdomain.\n\n### 6. In-Client OAuth vs Web OAuth\nUse `zoomSdk.authorize()` (In-Client) for best UX - no browser redirect. Only fall back to web redirect for initial install from Marketplace.\n\n### 7. Camera Mode CEF Race Condition\nCamera mode uses CEF which takes time to initialize. `drawImage`\u002F`drawWebView` may fail if called too early. Implement retry with exponential backoff.\n\n### 8. Cookie Configuration\nZoom's embedded browser requires cookies with `SameSite=None` and `Secure=true`. Without this, sessions break silently.\n\n### 9. State Validation\nAlways validate the OAuth `state` parameter to prevent CSRF attacks. Generate cryptographically random state, store it, and verify on callback.\n\n## Resources\n\n- **Official docs**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n- **SDK reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n- **NPM package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n- **Developer forum**: https:\u002F\u002Fdevforum.zoom.us\u002F\n- **GitHub SDK source**: https:\u002F\u002Fgithub.com\u002Fzoom\u002Fappssdk\n\n---\n\n**Need help?** Start with Integrated Index section below for complete navigation.\n\n---\n\n## Integrated Index\n\n_This section was migrated from `SKILL.md`._\n\n## Quick Start Path\n\n**If you're new to Zoom Apps, follow this order:**\n\n1. **Run preflight checks first** -> [RUNBOOK.md](RUNBOOK.md)\n\n2. **Read the architecture** -> [concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)\n   - Frontend\u002Fbackend pattern, embedded browser, deep linking\n   - Understand how Zoom loads and communicates with your app\n\n3. **Build your first app** -> [examples\u002Fquick-start.md](examples\u002Fquick-start.md)\n   - Complete Express + SDK Hello World\n   - ngrok setup for local development\n\n4. **Understand running contexts** -> [concepts\u002Frunning-contexts.md](concepts\u002Frunning-contexts.md)\n   - Where your app runs (inMeeting, inMainClient, inWebinar, etc.)\n   - Context-specific APIs and limitations\n\n5. **Implement OAuth** -> [examples\u002Fin-client-oauth.md](examples\u002Fin-client-oauth.md)\n   - In-Client OAuth with PKCE (best UX)\n   - Token exchange and storage\n\n6. **Add features** -> [references\u002Fapis.md](references\u002Fapis.md)\n   - 100+ SDK methods organized by category\n   - Code examples for each\n\n7. **Troubleshoot** -> [troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)\n   - Quick diagnostics for common problems\n\n---\n\n## Documentation Structure\n\n```\nzoom-apps-sdk\u002F\n├── SKILL.md                           # Main skill overview\n├── SKILL.md                           # This file - navigation guide\n│\n├── concepts\u002F                          # Core architectural patterns\n│   ├── architecture.md               # Frontend\u002Fbackend, embedded browser, OAuth flow\n│   ├── running-contexts.md           # Where your app runs + context-specific APIs\n│   └── security.md                   # OWASP headers, CSP, data access layers\n│\n├── examples\u002F                          # Complete working code\n│   ├── quick-start.md                # Hello World - minimal Express + SDK app\n│   ├── in-client-oauth.md            # In-Client OAuth with PKCE\n│   ├── layers-immersive.md           # Layers API - immersive mode (custom layouts)\n│   ├── layers-camera.md              # Layers API - camera mode (virtual camera)\n│   ├── collaborate-mode.md           # Collaborate mode (shared state)\n│   ├── guest-mode.md                 # Guest mode (unauthenticated -> authorized)\n│   ├── breakout-rooms.md             # Breakout room integration\n│   └── app-communication.md          # connect + postMessage between instances\n│\n├── troubleshooting\u002F                   # Problem solving guides\n│   ├── common-issues.md              # Quick diagnostics, error codes\n│   ├── debugging.md                  # Local dev setup, ngrok, browser preview\n│   └── migration.md                  # SDK version migration notes\n│\n└── references\u002F                        # Reference documentation\n    ├── apis.md                        # Complete API reference (100+ methods)\n    ├── events.md                      # All SDK events\n    ├── layers-api.md                  # Layers API detailed reference\n    ├── oauth.md                       # OAuth flows for Zoom Apps\n    └── zmail-sdk.md                   # Zoom Mail integration\n```\n\n---\n\n## By Use Case\n\n### I want to build a basic Zoom App\n1. [Architecture](concepts\u002Farchitecture.md) - Understand the pattern\n2. [Quick Start](examples\u002Fquick-start.md) - Build Hello World\n3. [In-Client OAuth](examples\u002Fin-client-oauth.md) - Add authorization\n4. [Security](concepts\u002Fsecurity.md) - Required headers\n\n### I want immersive video layouts (Layers API)\n1. [Layers Immersive](examples\u002Flayers-immersive.md) - Custom video positions\n2. [Layers API Reference](references\u002Flayers-api.md) - All drawing methods\n3. [App Communication](examples\u002Fapp-communication.md) - Sync layout across participants\n\n### I want a virtual camera overlay\n1. [Camera Mode](examples\u002Flayers-camera.md) - Camera mode rendering\n2. [Layers API Reference](references\u002Flayers-api.md) - Drawing methods\n\n### I want real-time collaboration\n1. [Collaborate Mode](examples\u002Fcollaborate-mode.md) - Shared state APIs\n2. [App Communication](examples\u002Fapp-communication.md) - Instance messaging\n\n### I want guest\u002Fanonymous access\n1. [Guest Mode](examples\u002Fguest-mode.md) - Three authorization states\n2. [In-Client OAuth](examples\u002Fin-client-oauth.md) - promptAuthorize flow\n\n### I want breakout room support\n1. [Breakout Rooms](examples\u002Fbreakout-rooms.md) - Room detection and state sync\n\n### I want to sync between main client and meeting\n1. [App Communication](examples\u002Fapp-communication.md) - connect + postMessage\n2. [Running Contexts](concepts\u002Frunning-contexts.md) - Multi-instance behavior\n\n### I want serverless deployment\n1. [Quick Start](examples\u002Fquick-start.md) - Understand the base pattern first\n2. Sample: [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) - Firebase pattern\n\n### I want to add Zoom Mail integration\n1. [Zoom Mail Reference](references\u002Fzmail-sdk.md) - REST API + mail plugins\n\n### I'm getting errors\n1. [Common Issues](troubleshooting\u002Fcommon-issues.md) - Quick diagnostic table\n2. [Debugging](troubleshooting\u002Fdebugging.md) - Local dev setup, DevTools\n3. [Migration](troubleshooting\u002Fmigration.md) - Version compatibility\n\n---\n\n## Most Critical Documents\n\n### 1. Architecture (FOUNDATION)\n**[concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)**\n\nUnderstand how Zoom Apps work: Frontend in embedded browser, backend for OAuth\u002FAPI, SDK as the bridge. Without this, nothing else makes sense.\n\n### 2. Quick Start (FIRST APP)\n**[examples\u002Fquick-start.md](examples\u002Fquick-start.md)**\n\nComplete working code. Get something running before diving into advanced features.\n\n### 3. Common Issues (MOST COMMON PROBLEMS)\n**[troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)**\n\n90% of Zoom Apps issues are: domain allowlist, global variable conflict, or missing capabilities.\n\n---\n\n## Key Learnings\n\n### Critical Discoveries:\n\n1. **Global Variable Conflict is the #1 Gotcha**\n   - CDN script defines `window.zoomSdk` globally\n   - `let zoomSdk = ...` causes SyntaxError in Zoom's browser\n   - Use `let sdk = window.zoomSdk` or NPM import\n\n2. **Domain Allowlist is Non-Negotiable**\n   - App shows blank panel with zero error if domain not whitelisted\n   - Must include your domain AND `appssdk.zoom.us` AND any CDN domains\n   - ngrok URLs change on restart - must update Marketplace each time\n\n3. **config() Gates Everything**\n   - Must be called first, must list all capabilities\n   - Unlisted capabilities throw errors\n   - Check `unsupportedApis` for client version compatibility\n\n4. **In-Client OAuth > Web OAuth for UX**\n   - `authorize()` keeps user in Zoom (no browser redirect)\n   - Web redirect only needed for initial Marketplace install\n   - Always implement PKCE (code_verifier + code_challenge)\n\n5. **Two App Instances Can Run Simultaneously**\n   - Main client instance + meeting instance\n   - Use `connect()` + `postMessage()` to sync between them\n   - Pre-meeting setup in main client, use in meeting\n\n6. **Camera Mode Has CEF Quirks**\n   - CEF initialization takes time\n   - Draw calls may fail if too early\n   - Use retry with exponential backoff\n\n7. **Cookie Settings Matter**\n   - `SameSite=None` + `Secure=true` required\n   - Without this, sessions silently fail in embedded browser\n\n---\n\n## Quick Reference\n\n### \"App shows blank panel\"\n-> [Domain Allowlist](troubleshooting\u002Fcommon-issues.md) - add domain to Marketplace\n\n### \"SyntaxError: redeclaration\"\n-> [Global Variable](troubleshooting\u002Fcommon-issues.md) - use `let sdk = window.zoomSdk`\n\n### \"config() throws error\"\n-> [Browser Preview](troubleshooting\u002Fdebugging.md) - SDK only works inside Zoom\n\n### \"API call fails silently\"\n-> [OAuth Scopes](troubleshooting\u002Fcommon-issues.md) - add required scopes in Marketplace\n\n### \"How do I implement [feature]?\"\n-> [API Reference](references\u002Fapis.md) - find the method, check capabilities needed\n\n### \"How do I test locally?\"\n-> [Debugging Guide](troubleshooting\u002Fdebugging.md) - ngrok + Marketplace config\n\n---\n\n## Document Version\n\nBased on **@zoom\u002Fappssdk v0.16.x** (latest: 0.16.26+)\n\n---\n\n**Happy coding!**\n\nStart with [Architecture](concepts\u002Farchitecture.md) to understand the pattern, then [Quick Start](examples\u002Fquick-start.md) to build your first app.\n","\u003C!-- Provenance: adapted from anthropics\u002Fknowledge-work-plugins (Apache-2.0, (c) Anthropic).\nOriginal skill: https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fknowledge-work-plugins\u002Ftree\u002Fmain\u002Fpartner-built\u002Fzoom-plugin\u002Fskills\u002Fzoom-apps-sdk. Changes for Muse AI: Claude\u002FCowork product refs -> Muse AI; MCP -> connector; CLAUDE.md -> MUSE.md; ${CLAUDE_PLUGIN_ROOT} -> this skill's directory; \u002Fplugin:command refs -> skill refs. -->\n\n\n# Zoom Apps SDK\n\nBackground reference for web apps that run inside the Zoom client. Prefer `choose-zoom-approach` first, then route here for Layers API, Collaborate Mode, in-client OAuth, and runtime constraints.\n\n# Zoom Apps SDK\n\nBuild web apps that run inside the Zoom client - meetings, webinars, main client, and Zoom Phone.\n\n**Official Documentation**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n**SDK Reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n**NPM Package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n\n## Quick Links\n\n**New to Zoom Apps? Follow this path:**\n\n1. **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking\n2. **[Quick Start](examples\u002Fquick-start.md)** - Complete working Express + SDK app\n3. **[Running Contexts](concepts\u002Frunning-contexts.md)** - Where your app runs (inMeeting, inMainClient, etc.)\n4. **[Zoom Apps vs Meeting SDK](concepts\u002Fmeeting-sdk-vs-zoom-apps.md)** - Stop mixing app types\n4. **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - Seamless authorization with PKCE\n5. **[API Reference](references\u002Fapis.md)** - 100+ SDK methods\n6. **Integrated Index** - see the section below in this file\n7. **[5-Minute Runbook](RUNBOOK.md)** - Preflight checks before deep debugging\n\n**Reference:**\n- **[API Reference](references\u002Fapis.md)** - All SDK methods by category\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API](references\u002Flayers-api.md)** - Immersive and camera mode rendering\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n**Having issues?**\n- App won't load in Zoom → Check [Domain Allowlist](#url-whitelisting-required) below\n- SDK errors → [Common Issues](troubleshooting\u002Fcommon-issues.md)\n- Local dev setup → [Debugging Guide](troubleshooting\u002Fdebugging.md)\n- Version upgrade → [Migration Guide](troubleshooting\u002Fmigration.md)\n- Forum-derived FAQs → [Forum Top Questions](troubleshooting\u002Fforum-top-questions.md)\n\n**Building immersive experiences?**\n- [Layers Immersive Mode](examples\u002Flayers-immersive.md) - Custom video layouts\n- [Camera Mode](examples\u002Flayers-camera.md) - Virtual camera overlays\n\n> **Need help with OAuth?** See the **[zoom-oauth](..\u002Foauth\u002FSKILL.md)** skill for authentication flows.\n\n## SDK Overview\n\nThe Zoom Apps SDK (`@zoom\u002Fappssdk`) provides JavaScript APIs for web apps running in Zoom's embedded browser:\n\n- **Context APIs** - Get meeting, user, and participant info\n- **Meeting Actions** - Share app, invite participants, open URLs\n- **Authorization** - In-Client OAuth with PKCE (no browser redirect)\n- **Layers API** - Immersive video layouts and camera mode overlays\n- **Collaborate Mode** - Shared app state across participants\n- **App Communication** - Message passing between app instances (main client \u003C-> meeting)\n- **Media Controls** - Virtual backgrounds, camera listing, recording control\n- **UI Controls** - Expand app, notifications, popout\n- **Events** - React to meeting state, participants, sharing, and more\n\n## Prerequisites\n\n- Zoom app configured as **\"Zoom App\"** type in [Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n- OAuth credentials (Client ID + Secret) with Zoom Apps scopes\n- Web application (Node.js + Express recommended)\n- **Your domain whitelisted** in Marketplace domain allowlist\n- ngrok or HTTPS tunnel for local development\n- Node.js 18+ (for the backend server)\n\n## Quick Start\n\n### Option A: NPM (Recommended for frameworks)\n\n```bash\nnpm install @zoom\u002Fappssdk\n```\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nasync function init() {\n  try {\n    const configResponse = await zoomSdk.config({\n      capabilities: [\n        'shareApp',\n        'getMeetingContext',\n        'getUserContext',\n        'openUrl'\n      ],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n    \u002F\u002F 'inMeeting' | 'inMainClient' | 'inWebinar' | 'inImmersive' | ...\n\n    const context = await zoomSdk.getMeetingContext();\n    console.log('Meeting ID:', context.meetingID);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n```\n\n### Option B: CDN (Vanilla JS)\n\n```html\n\u003Cscript src=\"https:\u002F\u002Fappssdk.zoom.us\u002Fsdk.js\">\u003C\u002Fscript>\n\n\u003Cscript>\n\u002F\u002F CRITICAL: Do NOT declare \"let zoomSdk\" - the SDK defines window.zoomSdk globally\n\u002F\u002F Using \"let zoomSdk = ...\" causes: SyntaxError: redeclaration of non-configurable global property\nlet sdk = window.zoomSdk;  \u002F\u002F Use a different variable name\n\nasync function init() {\n  try {\n    const configResponse = await sdk.config({\n      capabilities: ['shareApp', 'getMeetingContext', 'getUserContext'],\n      version: '0.16'\n    });\n\n    console.log('Running context:', configResponse.runningContext);\n  } catch (error) {\n    console.error('Not running inside Zoom:', error.message);\n    showDemoMode();\n  }\n}\n\nfunction showDemoMode() {\n  document.body.innerHTML = '\u003Ch1>Preview Mode\u003C\u002Fh1>\u003Cp>Open this app inside Zoom to use.\u003C\u002Fp>';\n}\n\ndocument.addEventListener('DOMContentLoaded', () => {\n  init();\n  setTimeout(() => { if (!sdk) showDemoMode(); }, 3000);\n});\n\u003C\u002Fscript>\n```\n\n## Critical: Global Variable Conflict\n\nThe CDN script defines `window.zoomSdk` globally. **Do NOT redeclare it:**\n\n```javascript\n\u002F\u002F WRONG - causes SyntaxError in Zoom's embedded browser\nlet zoomSdk = null;\nzoomSdk = window.zoomSdk;\n\n\u002F\u002F CORRECT - use different variable name\nlet sdk = window.zoomSdk;\n\n\u002F\u002F ALSO CORRECT - NPM import (no conflict)\nimport zoomSdk from '@zoom\u002Fappssdk';\n```\n\nThis only applies to the CDN approach. The NPM import creates a module-scoped variable, no conflict.\n\n## Browser Preview \u002F Demo Mode\n\nThe SDK only functions inside the Zoom client. When accessed in a regular browser:\n- `window.zoomSdk` exists but `sdk.config()` throws an error\n- Always implement try\u002Fcatch with fallback UI\n- Add timeout (3 seconds) in case SDK hangs\n\n## URL Whitelisting (Required)\n\n**Your app will NOT load in Zoom unless the domain is whitelisted.**\n\n1. Go to [Zoom Marketplace](https:\u002F\u002Fmarketplace.zoom.us\u002F)\n2. Open your app -> **Feature** tab\n3. Under **Zoom App**, find **Add Allow List**\n4. Add your domain (e.g., `yourdomain.com` for production, `xxxxx.ngrok.io` for dev)\n\nWithout this, the Zoom client shows a blank panel with no error message.\n\n## OAuth Scopes (Required)\n\nCapabilities require matching OAuth scopes enabled in Marketplace:\n\n| Capability | Required Scope |\n|------------|----------------|\n| `getMeetingContext` | `zoomapp:inmeeting` |\n| `getUserContext` | `zoomapp:inmeeting` |\n| `shareApp` | `zoomapp:inmeeting` |\n| `openUrl` | `zoomapp:inmeeting` |\n| `sendAppInvitation` | `zoomapp:inmeeting` |\n| `runRenderingContext` | `zoomapp:inmeeting` |\n| `authorize` | `zoomapp:inmeeting` |\n| `getMeetingParticipants` | `zoomapp:inmeeting` |\n\n**To add scopes:** Marketplace -> Your App -> **Scopes** tab -> Add required scopes.\n\nMissing scopes = capability fails silently or throws error. Users must re-authorize if you add new scopes.\n\n## Running Contexts\n\nYour app runs in different surfaces within Zoom. The `configResponse.runningContext` tells you where:\n\n| Context | Surface | Description |\n|---------|---------|-------------|\n| `inMeeting` | Meeting sidebar | Most common. Full meeting APIs available |\n| `inMainClient` | Main client panel | Home tab. No meeting context APIs |\n| `inWebinar` | Webinar sidebar | Host\u002Fpanelist. Meeting + webinar APIs |\n| `inImmersive` | Layers API | Full-screen custom rendering |\n| `inCamera` | Camera mode | Virtual camera overlay |\n| `inCollaborate` | Collaborate mode | Shared state context |\n| `inPhone` | Zoom Phone | Phone call app |\n| `inChat` | Team Chat | Chat sidebar |\n\nSee **[Running Contexts](concepts\u002Frunning-contexts.md)** for context-specific behavior and APIs.\n\n## SDK Initialization Pattern\n\nEvery Zoom App starts with `config()`:\n\n```javascript\nimport zoomSdk from '@zoom\u002Fappssdk';\n\nconst configResponse = await zoomSdk.config({\n  capabilities: [\n    \u002F\u002F List ALL APIs you will use\n    'getMeetingContext',\n    'getUserContext',\n    'shareApp',\n    'openUrl',\n    'authorize',\n    'onAuthorized'\n  ],\n  version: '0.16'\n});\n\n\u002F\u002F configResponse contains:\n\u002F\u002F {\n\u002F\u002F   runningContext: 'inMeeting',\n\u002F\u002F   clientVersion: '5.x.x',\n\u002F\u002F   unsupportedApis: []  \u002F\u002F APIs not supported in this client version\n\u002F\u002F }\n```\n\n**Rules:**\n1. `config()` MUST be called before any other SDK method\n2. Only capabilities listed in `config()` are available\n3. Capabilities must match OAuth scopes in Marketplace\n4. Check `unsupportedApis` for graceful degradation\n\n## In-Client OAuth (Summary)\n\nBest UX for authorization - no browser redirect:\n\n```javascript\n\u002F\u002F 1. Get code challenge from your backend\nconst { codeChallenge, state } = await fetch('\u002Fapi\u002Fauth\u002Fchallenge').then(r => r.json());\n\n\u002F\u002F 2. Trigger in-client authorization\nawait zoomSdk.authorize({ codeChallenge, state });\n\n\u002F\u002F 3. Listen for authorization result\nzoomSdk.addEventListener('onAuthorized', async (event) => {\n  const { code, state } = event;\n  \u002F\u002F 4. Send code to backend for token exchange\n  await fetch('\u002Fapi\u002Fauth\u002Ftoken', {\n    method: 'POST',\n    body: JSON.stringify({ code, state })\n  });\n});\n```\n\nSee **[In-Client OAuth Guide](examples\u002Fin-client-oauth.md)** for complete implementation.\n\n## Layers API (Summary)\n\nBuild immersive video layouts and camera overlays:\n\n```javascript\n\u002F\u002F Start immersive mode - replaces gallery view\nawait zoomSdk.runRenderingContext({ view: 'immersive' });\n\n\u002F\u002F Position participant video feeds\nawait zoomSdk.drawParticipant({\n  participantUUID: 'user-uuid',\n  x: 0, y: 0, width: 640, height: 480, zIndex: 1\n});\n\n\u002F\u002F Add overlay images\nawait zoomSdk.drawImage({\n  imageData: canvas.toDataURL(),\n  x: 0, y: 0, width: 1280, height: 720, zIndex: 0\n});\n\n\u002F\u002F Exit immersive mode\nawait zoomSdk.closeRenderingContext();\n```\n\nSee **[Layers Immersive](examples\u002Flayers-immersive.md)** and **[Camera Mode](examples\u002Flayers-camera.md)**.\n\n## Environment Variables\n\n| Variable | Description | Where to Find |\n|----------|-------------|---------------|\n| `ZOOM_APP_CLIENT_ID` | App client ID | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_CLIENT_SECRET` | App client secret | Marketplace -> App -> App Credentials |\n| `ZOOM_APP_REDIRECT_URI` | OAuth redirect URL | Your server URL + `\u002Fauth` |\n| `SESSION_SECRET` | Cookie signing secret | Generate random string |\n| `ZOOM_HOST` | Zoom host URL | `https:\u002F\u002Fzoom.us` (or `https:\u002F\u002Fzoomgov.com`) |\n\n## Common APIs\n\n| API | Description |\n|-----|-------------|\n| `config()` | Initialize SDK, request capabilities |\n| `getMeetingContext()` | Get meeting ID, topic, status |\n| `getUserContext()` | Get user name, role, participant ID |\n| `getRunningContext()` | Get current running context |\n| `getMeetingParticipants()` | List participants |\n| `shareApp()` | Share app screen with participants |\n| `openUrl({ url })` | Open URL in external browser |\n| `sendAppInvitation()` | Invite users to open your app |\n| `authorize()` | Trigger In-Client OAuth |\n| `connect()` | Connect to other app instances |\n| `postMessage()` | Send message to connected instances |\n| `runRenderingContext()` | Start Layers API (immersive\u002Fcamera) |\n| `expandApp({ action })` | Expand\u002Fcollapse app panel |\n| `showNotification()` | Show notification in Zoom |\n\n## Complete Documentation Library\n\n### Core Concepts\n- **[Architecture](concepts\u002Farchitecture.md)** - Frontend\u002Fbackend pattern, embedded browser, deep linking, X-Zoom-App-Context\n- **[Running Contexts](concepts\u002Frunning-contexts.md)** - All contexts, context-specific APIs, multi-instance communication\n- **[Security](concepts\u002Fsecurity.md)** - OWASP headers, CSP, cookie security, PKCE, token storage\n\n### Complete Examples\n- **[Quick Start](examples\u002Fquick-start.md)** - Hello World Express + SDK app\n- **[In-Client OAuth](examples\u002Fin-client-oauth.md)** - PKCE authorization flow\n- **[Layers Immersive](examples\u002Flayers-immersive.md)** - Custom video layouts\n- **[Camera Mode](examples\u002Flayers-camera.md)** - Virtual camera overlays\n- **[Collaborate Mode](examples\u002Fcollaborate-mode.md)** - Shared state across participants\n- **[Guest Mode](examples\u002Fguest-mode.md)** - Unauthenticated\u002Fauthenticated\u002Fauthorized states\n- **[Breakout Rooms](examples\u002Fbreakout-rooms.md)** - Room detection and cross-room state\n- **[App Communication](examples\u002Fapp-communication.md)** - connect + postMessage between instances\n\n### Troubleshooting\n- **[Common Issues](troubleshooting\u002Fcommon-issues.md)** - Quick diagnostics and error codes\n- **[Debugging](troubleshooting\u002Fdebugging.md)** - Local dev, ngrok, browser preview\n- **[Migration](troubleshooting\u002Fmigration.md)** - SDK version upgrade notes\n\n### References\n- **[API Reference](references\u002Fapis.md)** - All 100+ SDK methods\n- **[Events Reference](references\u002Fevents.md)** - All SDK event listeners\n- **[Layers API Reference](references\u002Flayers-api.md)** - Drawing and rendering methods\n- **[OAuth Reference](references\u002Foauth.md)** - OAuth flows for Zoom Apps\n- **[Zoom Mail](references\u002Fzmail-sdk.md)** - Mail plugin integration\n\n## Sample Repositories\n\n### Official (by Zoom)\n\n| Repository | Type | Last Updated | Status | SDK Version |\n|-----------|------|-------------|--------|-------------|\n| [zoomapps-sample-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-sample-js) | Hello World (Vanilla JS) | Dec 2025 | Active | ^0.16.26 |\n| [zoomapps-advancedsample-react](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-advancedsample-react) | Advanced (React + Redis) | Oct 2025 | Active | 0.16.0 |\n| [zoomapps-customlayout-js](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-customlayout-js) | Layers API | Nov 2023 | Stale | ^0.16.8 |\n| [zoomapps-texteditor-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-texteditor-vuejs) | Collaborate (Vue + Y.js) | Oct 2023 | Stale | ^0.16.7 |\n| [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) | Serverless (Firebase) | Aug 2024 | Stale | ^0.16.21 |\n| [zoomapps-cameramode-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-cameramode-vuejs) | Camera Mode | - | - | - |\n| [zoomapps-workshop-sample](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-workshop-sample) | Workshop | - | - | - |\n\n**Recommended for new projects:** Use `@zoom\u002Fappssdk` version `^0.16.26`.\n\n### Community\n\n| Type | Repository | Description |\n|------|------------|-------------|\n| Library | [harvard-edtech\u002Fzaccl](https:\u002F\u002Fgithub.com\u002Fharvard-edtech\u002Fzaccl) | Zoom App Complete Connection Library |\n\n**Full list**: See [general\u002Freferences\u002Fcommunity-repos.md](..\u002Fgeneral\u002Freferences\u002Fcommunity-repos.md)\n\n### Learning Path\n\n1. **Start**: `zoomapps-sample-js` - Simplest, most up-to-date\n2. **Advanced**: `zoomapps-advancedsample-react` - Comprehensive (In-Client OAuth, Guest Mode, Collaborate)\n3. **Specialized**: Pick based on feature (Layers, Serverless, Camera Mode)\n\n## Critical Gotchas (From Real Development)\n\n### 1. Global Variable Conflict\nThe CDN script defines `window.zoomSdk`. Declaring `let zoomSdk` in your code causes `SyntaxError: redeclaration of non-configurable global property`. Use `let sdk = window.zoomSdk` or the NPM import.\n\n### 2. Domain Allowlist\nYour app URL **must** be in the Marketplace domain allowlist. Without it, Zoom shows a blank panel with no error. Also add `appssdk.zoom.us` and any CDN domains you use.\n\n### 3. Capabilities Must Be Listed\nOnly APIs listed in `config({ capabilities: [...] })` are available. Calling an unlisted API throws an error. This is also true for event listeners.\n\n### 4. SDK Only Works Inside Zoom\n`zoomSdk.config()` throws outside the Zoom client. Always wrap in try\u002Fcatch with browser fallback:\n```javascript\ntry { await zoomSdk.config({...}); } catch { showBrowserPreview(); }\n```\n\n### 5. ngrok URL Changes\nFree ngrok URLs change on restart. You must update 4 places in Marketplace: Home URL, Redirect URL, OAuth Allow List, Domain Allow List. Consider ngrok paid plan for stable subdomain.\n\n### 6. In-Client OAuth vs Web OAuth\nUse `zoomSdk.authorize()` (In-Client) for best UX - no browser redirect. Only fall back to web redirect for initial install from Marketplace.\n\n### 7. Camera Mode CEF Race Condition\nCamera mode uses CEF which takes time to initialize. `drawImage`\u002F`drawWebView` may fail if called too early. Implement retry with exponential backoff.\n\n### 8. Cookie Configuration\nZoom's embedded browser requires cookies with `SameSite=None` and `Secure=true`. Without this, sessions break silently.\n\n### 9. State Validation\nAlways validate the OAuth `state` parameter to prevent CSRF attacks. Generate cryptographically random state, store it, and verify on callback.\n\n## Resources\n\n- **Official docs**: https:\u002F\u002Fdevelopers.zoom.us\u002Fdocs\u002Fzoom-apps\u002F\n- **SDK reference**: https:\u002F\u002Fappssdk.zoom.us\u002F\n- **NPM package**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zoom\u002Fappssdk\n- **Developer forum**: https:\u002F\u002Fdevforum.zoom.us\u002F\n- **GitHub SDK source**: https:\u002F\u002Fgithub.com\u002Fzoom\u002Fappssdk\n\n---\n\n**Need help?** Start with Integrated Index section below for complete navigation.\n\n---\n\n## Integrated Index\n\n_This section was migrated from `SKILL.md`._\n\n## Quick Start Path\n\n**If you're new to Zoom Apps, follow this order:**\n\n1. **Run preflight checks first** -> [RUNBOOK.md](RUNBOOK.md)\n\n2. **Read the architecture** -> [concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)\n   - Frontend\u002Fbackend pattern, embedded browser, deep linking\n   - Understand how Zoom loads and communicates with your app\n\n3. **Build your first app** -> [examples\u002Fquick-start.md](examples\u002Fquick-start.md)\n   - Complete Express + SDK Hello World\n   - ngrok setup for local development\n\n4. **Understand running contexts** -> [concepts\u002Frunning-contexts.md](concepts\u002Frunning-contexts.md)\n   - Where your app runs (inMeeting, inMainClient, inWebinar, etc.)\n   - Context-specific APIs and limitations\n\n5. **Implement OAuth** -> [examples\u002Fin-client-oauth.md](examples\u002Fin-client-oauth.md)\n   - In-Client OAuth with PKCE (best UX)\n   - Token exchange and storage\n\n6. **Add features** -> [references\u002Fapis.md](references\u002Fapis.md)\n   - 100+ SDK methods organized by category\n   - Code examples for each\n\n7. **Troubleshoot** -> [troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)\n   - Quick diagnostics for common problems\n\n---\n\n## Documentation Structure\n\n```\nzoom-apps-sdk\u002F\n├── SKILL.md                           # Main skill overview\n├── SKILL.md                           # This file - navigation guide\n│\n├── concepts\u002F                          # Core architectural patterns\n│   ├── architecture.md               # Frontend\u002Fbackend, embedded browser, OAuth flow\n│   ├── running-contexts.md           # Where your app runs + context-specific APIs\n│   └── security.md                   # OWASP headers, CSP, data access layers\n│\n├── examples\u002F                          # Complete working code\n│   ├── quick-start.md                # Hello World - minimal Express + SDK app\n│   ├── in-client-oauth.md            # In-Client OAuth with PKCE\n│   ├── layers-immersive.md           # Layers API - immersive mode (custom layouts)\n│   ├── layers-camera.md              # Layers API - camera mode (virtual camera)\n│   ├── collaborate-mode.md           # Collaborate mode (shared state)\n│   ├── guest-mode.md                 # Guest mode (unauthenticated -> authorized)\n│   ├── breakout-rooms.md             # Breakout room integration\n│   └── app-communication.md          # connect + postMessage between instances\n│\n├── troubleshooting\u002F                   # Problem solving guides\n│   ├── common-issues.md              # Quick diagnostics, error codes\n│   ├── debugging.md                  # Local dev setup, ngrok, browser preview\n│   └── migration.md                  # SDK version migration notes\n│\n└── references\u002F                        # Reference documentation\n    ├── apis.md                        # Complete API reference (100+ methods)\n    ├── events.md                      # All SDK events\n    ├── layers-api.md                  # Layers API detailed reference\n    ├── oauth.md                       # OAuth flows for Zoom Apps\n    └── zmail-sdk.md                   # Zoom Mail integration\n```\n\n---\n\n## By Use Case\n\n### I want to build a basic Zoom App\n1. [Architecture](concepts\u002Farchitecture.md) - Understand the pattern\n2. [Quick Start](examples\u002Fquick-start.md) - Build Hello World\n3. [In-Client OAuth](examples\u002Fin-client-oauth.md) - Add authorization\n4. [Security](concepts\u002Fsecurity.md) - Required headers\n\n### I want immersive video layouts (Layers API)\n1. [Layers Immersive](examples\u002Flayers-immersive.md) - Custom video positions\n2. [Layers API Reference](references\u002Flayers-api.md) - All drawing methods\n3. [App Communication](examples\u002Fapp-communication.md) - Sync layout across participants\n\n### I want a virtual camera overlay\n1. [Camera Mode](examples\u002Flayers-camera.md) - Camera mode rendering\n2. [Layers API Reference](references\u002Flayers-api.md) - Drawing methods\n\n### I want real-time collaboration\n1. [Collaborate Mode](examples\u002Fcollaborate-mode.md) - Shared state APIs\n2. [App Communication](examples\u002Fapp-communication.md) - Instance messaging\n\n### I want guest\u002Fanonymous access\n1. [Guest Mode](examples\u002Fguest-mode.md) - Three authorization states\n2. [In-Client OAuth](examples\u002Fin-client-oauth.md) - promptAuthorize flow\n\n### I want breakout room support\n1. [Breakout Rooms](examples\u002Fbreakout-rooms.md) - Room detection and state sync\n\n### I want to sync between main client and meeting\n1. [App Communication](examples\u002Fapp-communication.md) - connect + postMessage\n2. [Running Contexts](concepts\u002Frunning-contexts.md) - Multi-instance behavior\n\n### I want serverless deployment\n1. [Quick Start](examples\u002Fquick-start.md) - Understand the base pattern first\n2. Sample: [zoomapps-serverless-vuejs](https:\u002F\u002Fgithub.com\u002Fzoom\u002Fzoomapps-serverless-vuejs) - Firebase pattern\n\n### I want to add Zoom Mail integration\n1. [Zoom Mail Reference](references\u002Fzmail-sdk.md) - REST API + mail plugins\n\n### I'm getting errors\n1. [Common Issues](troubleshooting\u002Fcommon-issues.md) - Quick diagnostic table\n2. [Debugging](troubleshooting\u002Fdebugging.md) - Local dev setup, DevTools\n3. [Migration](troubleshooting\u002Fmigration.md) - Version compatibility\n\n---\n\n## Most Critical Documents\n\n### 1. Architecture (FOUNDATION)\n**[concepts\u002Farchitecture.md](concepts\u002Farchitecture.md)**\n\nUnderstand how Zoom Apps work: Frontend in embedded browser, backend for OAuth\u002FAPI, SDK as the bridge. Without this, nothing else makes sense.\n\n### 2. Quick Start (FIRST APP)\n**[examples\u002Fquick-start.md](examples\u002Fquick-start.md)**\n\nComplete working code. Get something running before diving into advanced features.\n\n### 3. Common Issues (MOST COMMON PROBLEMS)\n**[troubleshooting\u002Fcommon-issues.md](troubleshooting\u002Fcommon-issues.md)**\n\n90% of Zoom Apps issues are: domain allowlist, global variable conflict, or missing capabilities.\n\n---\n\n## Key Learnings\n\n### Critical Discoveries:\n\n1. **Global Variable Conflict is the #1 Gotcha**\n   - CDN script defines `window.zoomSdk` globally\n   - `let zoomSdk = ...` causes SyntaxError in Zoom's browser\n   - Use `let sdk = window.zoomSdk` or NPM import\n\n2. **Domain Allowlist is Non-Negotiable**\n   - App shows blank panel with zero error if domain not whitelisted\n   - Must include your domain AND `appssdk.zoom.us` AND any CDN domains\n   - ngrok URLs change on restart - must update Marketplace each time\n\n3. **config() Gates Everything**\n   - Must be called first, must list all capabilities\n   - Unlisted capabilities throw errors\n   - Check `unsupportedApis` for client version compatibility\n\n4. **In-Client OAuth > Web OAuth for UX**\n   - `authorize()` keeps user in Zoom (no browser redirect)\n   - Web redirect only needed for initial Marketplace install\n   - Always implement PKCE (code_verifier + code_challenge)\n\n5. **Two App Instances Can Run Simultaneously**\n   - Main client instance + meeting instance\n   - Use `connect()` + `postMessage()` to sync between them\n   - Pre-meeting setup in main client, use in meeting\n\n6. **Camera Mode Has CEF Quirks**\n   - CEF initialization takes time\n   - Draw calls may fail if too early\n   - Use retry with exponential backoff\n\n7. **Cookie Settings Matter**\n   - `SameSite=None` + `Secure=true` required\n   - Without this, sessions silently fail in embedded browser\n\n---\n\n## Quick Reference\n\n### \"App shows blank panel\"\n-> [Domain Allowlist](troubleshooting\u002Fcommon-issues.md) - add domain to Marketplace\n\n### \"SyntaxError: redeclaration\"\n-> [Global Variable](troubleshooting\u002Fcommon-issues.md) - use `let sdk = window.zoomSdk`\n\n### \"config() throws error\"\n-> [Browser Preview](troubleshooting\u002Fdebugging.md) - SDK only works inside Zoom\n\n### \"API call fails silently\"\n-> [OAuth Scopes](troubleshooting\u002Fcommon-issues.md) - add required scopes in Marketplace\n\n### \"How do I implement [feature]?\"\n-> [API Reference](references\u002Fapis.md) - find the method, check capabilities needed\n\n### \"How do I test locally?\"\n-> [Debugging Guide](troubleshooting\u002Fdebugging.md) - ngrok + Marketplace config\n\n---\n\n## Document Version\n\nBased on **@zoom\u002Fappssdk v0.16.x** (latest: 0.16.26+)\n\n---\n\n**Happy coding!**\n\nStart with [Architecture](concepts\u002Farchitecture.md) to understand the pattern, then [Quick Start](examples\u002Fquick-start.md) to build your first app.\n",{"name":5,"triggers":24,"description":7,"user-invocable":20},[25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"zoom app","in-meeting app","app inside zoom","zoom client app","layers api","immersive mode","camera mode","collaborate mode","appssdk","in-client oauth","zoom mail","domain allowlist","domain whitelist","url whitelisting","blank panel","runningContext","zoomSdk","main","af388a77c2fe5e0b4fd879cca4300a0ffa9a6579","skills\u002Fams-kw-zoom-apps-sdk",1,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis","https:\u002F\u002Fgithub.com\u002FTanNhatCMS","https:\u002F\u002Fmrkiet.name.vn","2026-11-07 14:23:08",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add TanNhatCMS\u002Fjarvis --skill zoom-apps-sdk",{"tool":56,"command":57},"bunx","bunx skills add TanNhatCMS\u002Fjarvis --skill zoom-apps-sdk",{"tool":59,"command":60},"pnpm","pnpm dlx skills add TanNhatCMS\u002Fjarvis --skill zoom-apps-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002FSKILL.md",true,[64,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138,142,146,150,154,158],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"concepts\u002Farchitecture.md","REFERENCE","参考文档",7864,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fconcepts\u002Farchitecture.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"concepts\u002Fmeeting-sdk-vs-zoom-apps.md",1066,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fconcepts\u002Fmeeting-sdk-vs-zoom-apps.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"concepts\u002Frunning-contexts.md",5745,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fconcepts\u002Frunning-contexts.md",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"concepts\u002Fsecurity.md",5486,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fconcepts\u002Fsecurity.md",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"CONNECTORS.md",2407,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002FCONNECTORS.md",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"examples\u002Fapp-communication.md",3724,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fapp-communication.md",{"path":91,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":92,"sourceHtmlUrl":93},"examples\u002Fbreakout-rooms.md",3313,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fbreakout-rooms.md",{"path":95,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":96,"sourceHtmlUrl":97},"examples\u002Fcollaborate-mode.md",4185,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fcollaborate-mode.md",{"path":99,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":100,"sourceHtmlUrl":101},"examples\u002Fguest-mode.md",3585,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fguest-mode.md",{"path":103,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":104,"sourceHtmlUrl":105},"examples\u002Fin-client-oauth.md",6272,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fin-client-oauth.md",{"path":107,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":108,"sourceHtmlUrl":109},"examples\u002Flayers-camera.md",5818,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Flayers-camera.md",{"path":111,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":112,"sourceHtmlUrl":113},"examples\u002Flayers-immersive.md",8041,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Flayers-immersive.md",{"path":115,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":116,"sourceHtmlUrl":117},"examples\u002Fquick-start.md",7445,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Fexamples\u002Fquick-start.md",{"path":119,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":120,"sourceHtmlUrl":121},"references\u002Fapis.md",5417,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Fapis.md",{"path":123,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fenvironment-variables.md",1108,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Fenvironment-variables.md",{"path":127,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Fevents.md",3904,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Fevents.md",{"path":131,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Flayers-api.md",16129,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Flayers-api.md",{"path":135,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":136,"sourceHtmlUrl":137},"references\u002Foauth.md",5418,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Foauth.md",{"path":139,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":140,"sourceHtmlUrl":141},"references\u002Fzmail-sdk.md",5616,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Freferences\u002Fzmail-sdk.md",{"path":143,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":144,"sourceHtmlUrl":145},"RUNBOOK.md",3412,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002FRUNBOOK.md",{"path":147,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":148,"sourceHtmlUrl":149},"troubleshooting\u002Fcommon-issues.md",4376,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Ftroubleshooting\u002Fcommon-issues.md",{"path":151,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":152,"sourceHtmlUrl":153},"troubleshooting\u002Fdebugging.md",3626,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Ftroubleshooting\u002Fdebugging.md",{"path":155,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":156,"sourceHtmlUrl":157},"troubleshooting\u002Fforum-top-questions.md",1086,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Ftroubleshooting\u002Fforum-top-questions.md",{"path":159,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":160,"sourceHtmlUrl":161},"troubleshooting\u002Fmigration.md",3030,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-kw-zoom-apps-sdk\u002Ftroubleshooting\u002Fmigration.md",[163,170,178,185,192,199],{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":19},"01M7EWYJR0J8DARY7E59Z6Y9MV","web-scrape","Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open\u002Ffetch fails on JS-heavy pages, or when you need clean markdown\u002Fstructured extraction from a site. Requires FIRECRAWL_API_KEY.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fweb-scrape\u002FSKILL.md",[],[],{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":174,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":19},"01M7EWYBN5P6F2AJG3FR24T9BP","design-taste-frontend","tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML\u002FCSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, \"AI-made\", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FSKILL.md",[],[],{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":19},"01M7EWY8FQFNQ2GB7NZZWGSSDX","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-tdd\u002FSKILL.md",[],[],{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":191,"publishedAt":19},"01M7EWY5SHBFRH1HDHVWM9K7TV","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-debugging\u002FSKILL.md",[],[],{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":198,"publishedAt":19},"01M7EWY3NM0Z0JAKS7HDZ24K66","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-code-review\u002FSKILL.md",[],[],{"skillNo":200,"name":201,"nameZh":6,"description":202,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":203,"categories":204,"keywords":205,"publishedAt":19},"01M7EWY0WRMWX4M9ZFY0WKC593","brainstorming","You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-brainstorming\u002FSKILL.md",[],[]]