zoom-video-sdk-macos

Zoom Video SDK for macOS native desktop apps. Use when building custom macOS video sessions with native UI control, tokenized join, and desktop-oriented media/device workflows.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/zoom/skills/video-sdk/macos/SKILL.md

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an excellent token-efficient index but scores low on actionability and workflow clarity because it offers links rather than executable guidance or a validated operational sequence, and several referenced bundle files do not exist.

Suggestions

Add one minimal executable snippet directly in the body (e.g., SDK init or JWT token generation) so Claude has concrete guidance before opening references, lifting actionability.

Include a short operational workflow with validation checkpoints (generate/verify token → join session → confirm participant/subscriber state) rather than only a reading-order list.

Reconcile the bundle: macos.md, concepts/*, examples/*, scenarios/*, troubleshooting/common-issues.md, and RUNBOOK.md are referenced but absent — either add them or remove the broken links so progressive-disclosure navigation actually resolves.

Dimension	Reasoning	Score
Conciseness	The body is a lean ~30-line overview/index: a one-line purpose, a numbered Start Here list, source URLs, and a RUNBOOK pointer, with every token earning its place and no padding or restating of concepts Claude already knows.	5 / 5
Actionability	Provides only navigation — a link list and URLs — with no concrete code, commands, or specific steps to execute; guidance is high-level ('Use this skill when building...') rather than instructive.	2 / 5
Workflow Clarity	The numbered 'Start Here' list gives an orientation sequence, but it is a reading order rather than an operational workflow, and there are no validation checkpoints or feedback loops despite the SDK join/setup being a multi-step, failure-prone process.	3 / 5
Progressive Disclosure	Structure is good and one-level-deep with clearly categorized, well-signaled references (concepts/, examples/, scenarios/, references/, troubleshooting/), but six of the nine referenced paths plus RUNBOOK.md are missing from the actual bundle, so navigation is partly broken.	4 / 5
	Total	14 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it concisely pairs a concrete capability statement with an explicit 'Use when' trigger scoped to a distinct macOS-native niche. Minor gains are possible only in trigger synonym coverage and enumerating more SDK actions.

Dimension	Reasoning	Score
Specificity	Names the domain ('Zoom Video SDK for macOS native desktop apps') and several concrete capabilities — 'native UI control, tokenized join, and desktop-oriented media/device workflows' — covering multiple specific actions, though coverage is not exhaustive of the full SDK surface.	4 / 5
Completeness	Explicitly states both what ('Zoom Video SDK for macOS native desktop apps' plus its capability list) and when ('Use when building custom macOS video sessions...') with concrete trigger phrases, in the standard third-person 'Use when...' form.	5 / 5
Trigger Term Quality	Good natural keyword coverage ('macOS video sessions', 'video SDK', 'native UI control', 'tokenized join', 'media/device workflows') that users would plausibly say, with a few common synonyms/extensions (e.g., 'Zoom Video SDK macOS', file-like tokens) absent.	4 / 5
Distinctiveness Conflict Risk	A clear niche — Zoom Video SDK scoped to macOS native desktop apps — with triggers ('macOS video sessions', 'tokenized join') unlikely to fire for unrelated skills, giving minimal conflict risk.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 7 missing, 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: openai/plugins
Path: plugins/zoom/skills/video-sdk/macos/SKILL.md
Commit: 1e28582

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.