CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

twilio-numbers-senders

Choose the right Twilio number type and sender BEFORE building. Covers phone numbers (local, toll-free, short code, mobile), alphanumeric sender IDs, WhatsApp senders, RCS agents, international availability, and regulatory bundles. Each number type has its own compliance program — choosing wrong means rebuilding. Use this skill first.

60

Quality

75%

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/twilio-developer-kit/skills/twilio-numbers-senders/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

A dense, decision-oriented reference body with strong actionability (specific throughput, timelines, API constraints, and decision rules) and clean sequencing via the lifecycle line. The main structural weakness is that the deep Branded Calling / voice-trust detail is inlined rather than split into a reference file, since the skill ships with no bundle at all.

Suggestions

Move the Branded Calling prerequisites, display standards, and carrier-support detail into a references/ file (e.g. voice-trust.md) and keep a short summary table in SKILL.md, enabling one-level-deep progressive disclosure.

Give the "How to Choose" heuristics a defined order (e.g. capability → volume → timeline → budget) so the decision workflow reads as a sequence rather than an unordered list.

Tighten the international section with the same decision-rule format used for US numbers, or point to a dedicated reference if the country-by-country detail grows.

DimensionReasoningScore

Conciseness

The body is dominated by dense comparison tables and terse bullet lists ("Unverified toll-free numbers cannot send SMS to US/Canada") with little padding — above anchor 3's "some unnecessary explanation" but short of anchor 5 because the ~55-line Branded Calling prerequisites/display-standards deep-dive is more than a choosing decision needs inline.

4 / 5

Actionability

Concrete, executable decision guidance throughout: "Need voice + SMS from same number? → Local (10DLC) or toll-free", specific throughput figures, approval timelines, API error code 30034, and API-level CANNOT facts ("availablePhoneNumbers('US').mobile.list() returns 404"). Per the rubric's scoring note, absence of code is not penalized for instruction-only skills when guidance is actionable; it misses anchor 5 only because the international section stays high-level.

4 / 5

Workflow Clarity

The lifecycle line "Choose numbers/senders (this skill) → Register them → Follow traffic rules" gives a clear sequence, and the skill's single decision task is unambiguous with a structured decision list, common mistakes, and next steps. It sits below anchor 5 because the "How to Choose" heuristics are an unordered list rather than a sequenced flow with checkpoints; no destructive/batch operations exist, so no validation cap applies.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, assets/), so all content is inline. Section structure and headings are good, but content that clearly belongs in a separate file — the Branded Calling prerequisites, display-standards tables, carrier support, and display-name rules — is inlined, matching anchor 3 ("content that should be separate is inline") rather than anchor 4's well-split layout. The skill does clearly point to sibling skills by name in Next Steps.

3 / 5

Total

15

/

20

Passed

Description

66%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.

A specific, well-scoped description that clearly names the Twilio number/sender selection domain and its concrete sub-topics. Its main weaknesses are the absence of an explicit "Use when..." trigger clause (the "when" is only implied by "Use this skill first") and missing high-frequency trigger keywords like 10DLC/A2P.

Suggestions

Add an explicit trigger clause, e.g. "Use when starting any Twilio messaging or voice project, before buying numbers or selecting senders."

Include the terms users actually say when they hit this decision point: "10DLC", "A2P registration", "toll-free verification", "buy a Twilio number".

Trim the consequence framing ("choosing wrong means rebuilding") to free room for trigger conditions, which matter more for skill selection.

DimensionReasoningScore

Specificity

"Covers phone numbers (local, toll-free, short code, mobile), alphanumeric sender IDs, WhatsApp senders, RCS agents, international availability, and regulatory bundles" enumerates many concrete entities across the domain, but the action side is a single verb ("Choose the right Twilio number type and sender"), so it sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive multiple concrete actions).

4 / 5

Completeness

The "what" is clear and concrete, but the "when" is only weakly implied — "BEFORE building" and "Use this skill first" give ordering, not an explicit trigger condition. Per the rubric guideline, a missing "Use when..." clause (or equivalent explicit trigger guidance) caps completeness at 3; it is above anchor 2 because the what is specific, not vague.

3 / 5

Trigger Term Quality

Good natural keyword coverage ("Twilio", "toll-free", "short code", "WhatsApp", "RCS", "sender", "regulatory bundles") but misses common phrases users would actually say such as "10DLC", "A2P", or "buy a phone number", matching anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Choose the right Twilio number type and sender" carves a clear niche distinct from generic skills, but heavy compliance vocabulary ("compliance program", "regulatory bundles") creates minor overlap risk with the sibling onboarding/traffic compliance skills referenced in the lifecycle, fitting anchor 4 (mostly distinct, minor overlap with closely related skills) rather than anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/twilio-developer-kit/skills/twilio-numbers-senders/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.