CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plan-zoom-integration

Use when planning Zoom integrations.

53

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/zoom/skills/plan-zoom-integration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 exemplary lean, well-sectioned command prompt: no token waste, a clear six-step sequence, and a defined output contract. Its main gap is executability of the choices it asks for — 'Choose the correct Zoom surface' and 'Define auth requirements' carry no criteria, surface list, or example scopes, so a run relies entirely on the model's prior Zoom knowledge.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: it never explains what Zoom, OAuth, or webhooks are, and every line ('Capture the target user flow and success criteria', 'End with the smallest deliverable that proves the architecture') either instructs or defines output. This matches 'Lean and efficient; assumes Claude's competence; every token earns its place'.

5 / 5

Actionability

The workflow names concrete deliverables (auth and scope checklist, delivery phases, architecture summary) but gives no criteria for 'Choose the correct Zoom surface and supporting services' — no list of surfaces (Meetings, Chat apps, Phone), no example scopes, and no commands or templates. This is 'Some concrete guidance but incomplete; missing key details', not 4, because a model executing step 2 has nothing to act on beyond general knowledge.

3 / 5

Workflow Clarity

Six steps in a sensible order (capture requirements → choose surface → auth → phases → risks → minimal deliverable) plus an explicit Output section defining the deliverable, matching 'Clear sequence with most checkpoints present'. It is not 5 because there are no checkpoints at all (e.g. confirm assumptions with the user before drafting phases), and not 3 because the sequence is complete and the final output is unambiguous.

4 / 5

Progressive Disclosure

The ~35-line body is appropriately split into Usage, Workflow, Output, and Related Skills with no content that belongs in a separate file, and cross-references are clearly signaled and one level deep. It is not 5 because every reference (../../README.md and four sibling SKILL.md links) points outside the bundle — none resolve within the skill's own file structure — leaving the README pointer as unverifiable navigation rather than confirmed one-level-deep references.

4 / 5

Total

16

/

20

Passed

Description

45%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 concise and has an explicit 'Use when' trigger, but it answers only 'when' and not 'what': it never states the skill's actual capability (creating a phased build plan for Zoom integrations) and omits natural trigger variations like 'Zoom app', 'Zoom API', or 'Zoom bot'. Adding a one-line capability statement and a few synonym triggers would lift both completeness and trigger quality.

Suggestions

State the 'what' alongside the 'when', e.g. 'Creates a practical, phased build plan for Zoom integrations covering surfaces, auth scopes, and risks. Use when planning a Zoom integration or app.' — specificity scored at the bottom of the scale (2) because no capability is named.

Add natural trigger synonyms users actually say, such as 'Zoom app', 'Zoom API', 'Zoom bot', 'meeting app', or 'OAuth setup', to raise trigger_term_quality from 'some relevant keywords' to good coverage.

Distinguish the skill from its siblings (build-zoom-meeting-app, build-zoom-bot, setup-zoom-oauth) — e.g. 'Use when planning the overall architecture of a Zoom integration, before building a specific app or bot' — to reduce overlap risk.

DimensionReasoningScore

Specificity

The phrase 'planning Zoom integrations' names a concrete domain but states no capability at all — there is no 'what does this skill do' action, matching the anchor 'Names the domain but actions are minimal or generic'. It is not a 1 because 'Zoom integrations' is a concrete, specific domain rather than the pure abstraction of 'Helps with documents'.

2 / 5

Completeness

The description has an explicit 'when' clause ('Use when planning Zoom integrations') but completely lacks a 'what' — it never states that the skill creates a build plan. This sits between anchor 2 ('only when present without what', e.g. 'Use when working with documents') and anchor 3 ('clear what but when missing'), landing at 3 since the trigger guidance is explicit and the skill's function is at least weakly implied by 'planning'.

3 / 5

Trigger Term Quality

'Use when planning Zoom integrations' includes natural terms ('planning', 'Zoom', 'integrations') a user would say, but misses common variations and synonyms users actually use such as 'Zoom app', 'Zoom API', 'bot', 'meeting', 'OAuth', or 'marketplace', matching 'Some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

'Zoom' carves out a real niche, but the description would also fire for requests handled by closely related sibling skills the body lists (build-zoom-meeting-app, build-zoom-bot, setup-zoom-oauth) since 'planning Zoom integrations' plausibly covers 'build a Zoom bot' — matching 'Somewhat specific but could still overlap with similar skills'.

3 / 5

Total

11

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 5 suspicious

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/zoom/skills/plan-zoom-integration/SKILL.md

Reviewed

Table of Contents

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.