CtrlK
BlogDocsLog inGet started
Tessl Logo

choose-zoom-approach

Use when choosing architecture.

48

Quality

53%

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/choose-zoom-approach/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 a lean, well-structured router skill: a concrete decision table, explicit anti-pattern guardrails, and a defined output contract, with details correctly delegated to the per-surface skill files. Its only weakness is mild residual ambiguity in multi-option table rows and the unspecified shape of the required deliverables.

DimensionReasoningScore

Conciseness

The body is ~30 lines with zero padding: 'Pick the smallest correct Zoom surface for the job, then layer in only the supporting pieces that are actually required' plus a decision table, three guardrails, and a four-item output list. Every line is decision-relevant and nothing explains concepts Claude already knows — matching anchor 5 ('lean and efficient; every token earns its place').

5 / 5

Actionability

The decision table gives concrete problem-type→surface mappings, and guardrails give explicit rules ('Do not recommend Video SDK when the user actually needs Zoom meeting semantics'), so the guidance is actionable without code. It falls short of anchor 5 because 'What To Produce' specifies deliverable categories ('Immediate next implementation step', 'Minimum supporting components') but not what a concrete deliverable looks like, leaving minor gaps.

4 / 5

Workflow Clarity

The decision flow is coherent and unambiguous for most inputs: match problem type in the table, apply guardrails, produce the four listed outputs. It scores 4 rather than 5 because several rows present alternatives without a tie-breaker ('webhooks or websockets', 'contact-center or virtual-agent', 'rtms plus meeting-sdk when needed' — 'when needed' is undefined), leaving minor gaps in checkpoint criteria. No validation loop is required since this is a non-destructive decision skill.

4 / 5

Progressive Disclosure

The skill is under 50 lines, well-organized into sections, and keeps detail out of SKILL.md by linking each Zoom surface to its own skill one level deep ('[rest-api](../rest-api/SKILL.md)', '[meeting-sdk](../meeting-sdk/SKILL.md)') — clear overview, well-signaled one-level references, easy navigation, matching anchor 5. No bundle directories exist, and none are needed at this size.

5 / 5

Total

18

/

20

Passed

Description

20%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 effectively just a trigger clause with no statement of what the skill does. It omits the Zoom domain, the routing/decision nature of the skill, and any natural Zoom-related trigger terms, so it would both under-trigger for real Zoom API-selection questions and over-trigger for general architecture questions.

Suggestions

State what the skill does before the trigger, e.g. 'Routes Zoom integration work to the smallest correct Zoom surface (REST API, Webhooks, Meeting SDK, Video SDK, Zoom Apps, RTMS, Phone, Contact Center).' — this fixes both the missing 'what' and the absent domain naming.

Replace the generic trigger 'choosing architecture' with the natural phrases users would say, e.g. 'Use when the user mentions Zoom, a Zoom API/SDK, or asks which Zoom integration approach to use.'

Add synonym coverage (Zoom REST, webhooks vs websockets, meeting bots, embedding Zoom meetings) to reduce conflict risk with generic architecture-design skills.

DimensionReasoningScore

Specificity

The entire description is 'Use when choosing architecture.' — no concrete actions or capabilities are stated at all, only an abstract trigger. It matches anchor 1 ('entirely vague; no concrete actions; pure abstract language'); it cannot be a 2 because it does not even name the domain (Zoom) or a minimal action.

1 / 5

Completeness

Only a vague 'when' is present ('Use when choosing architecture') with no 'what' whatsoever — matching anchor 2 ('only when is present without what'). It is not a 3 because the 'when' itself is too vague to weakly imply a what, and not a 1 because a trigger clause does exist.

2 / 5

Trigger Term Quality

The only keyword is the generic phrase 'choosing architecture'; natural terms a user would actually say ('Zoom', 'REST API', 'webhooks', 'Meeting SDK', 'which Zoom surface') are entirely absent. This sits at anchor 2 (one or two generic keywords, missing the natural phrases users say) rather than 1, because 'choosing architecture' is at least a plausible trigger phrase and not pure technical jargon.

2 / 5

Distinctiveness Conflict Risk

'Choosing architecture' is very broad and would collide with any software/system architecture discussion — high overlap risk (anchor 2). It is not a 1 because the phrase is at least scoped to an architecture-selection decision rather than any request ('helps with code and documents').

2 / 5

Total

7

/

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: 11 suspicious

Warning

Total

15

/

16

Passed

Repository
openai/plugins
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.