CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

twilio-marketing-promotions-advisor

Planning skill for marketing and promotional messaging. Qualifies the developer's campaign needs across channel selection, compliance, audience segmentation, and delivery tracking to recommend the right Twilio messaging architecture. Handles both "set up a promotional SMS campaign" and "build a multi-channel engagement pipeline with Segment integration."

59

Quality

74%

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-marketing-promotions-advisor/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 well-structured, information-dense advisory framework with concrete decision rules and a usable output template; its main weaknesses are a dangling reference to a nonexistent Channel Mix Matrix and noticeable repetition of credential details and skill lists.

Suggestions

Resolve the 'Channel Mix Matrix — Marketing column' reference — either add the matrix as a bundled reference file or remove/inline the needed column values.

Deduplicate the email-credential parenthetical and the skills-to-install list by stating them once and having the campaign ladder reference the Output Format section.

Add a brief final verification step (e.g., 'confirm the recommended level against the answers to the 6 questions and the compliance checklist') to close the workflow's validation loop.

DimensionReasoningScore

Conciseness

Mostly dense, decision-relevant Twilio facts Claude cannot be assumed to know (A2P 10DLC timelines, per-number-type throughput, 24-hour WhatsApp window), with minor repetition that could be trimmed — the email credential parenthetical '(Account SID + Auth Token, comms.twilio.com)...(SendGrid API key, SG.-prefix)' appears three times and the installable-skills list is duplicated between the campaign ladder and the Output Format.

4 / 5

Actionability

Highly actionable for an instruction-only skill: six named qualification questions with decision branches per answer, a campaign ladder keyed to developer quotes, and a copy-ready Output Format template; the main gap is the reference to a 'Channel Mix Matrix — Marketing column' that is not present in the bundle.

4 / 5

Workflow Clarity

Clear, well-sequenced flow (Mode detection → 6 questions → sophistication ladder → compliance gate → output template) with compliance explicitly framed as blocking ('Compliance failures block sends'); minor validation gap in that there is no step verifying the recommendation against the collected answers before presenting it.

4 / 5

Progressive Disclosure

The single-file body is well-sectioned, but the pointer 'Reference Channel Mix Matrix — Marketing column' targets a resource that does not exist in this bundle and is not clearly signaled, and reference-like material (channel comparison table, compliance details, rate limits) is inlined with no one-level-deep navigation.

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 strong, specific description in third person with good trigger vocabulary, but it lacks an explicit 'Use when...' activation clause, leaving the 'when' only weakly conveyed through two example requests and capping completeness.

Suggestions

Add an explicit 'Use when the user asks about promotional SMS campaigns, bulk sends, marketing WhatsApp templates, or multi-channel engagement pipelines' clause to answer 'when' directly.

Broaden trigger vocabulary to include common user phrasings like 'bulk SMS', 'mass email', 'drip campaign', and 'WhatsApp templates'.

Trim the two quoted example requests to one line so the description stays concise once the Use-when clause is added.

DimensionReasoningScore

Specificity

Lists several concrete third-person actions — 'Qualifies the developer's campaign needs across channel selection, compliance, audience segmentation, and delivery tracking to recommend the right Twilio messaging architecture' — with only minor gaps in coverage (does not enumerate what the skill does after recommending).

4 / 5

Completeness

The 'what' is clear (qualification and architecture recommendation for Twilio messaging), but there is no 'Use when...' clause or equivalent explicit activation guidance — the quoted phrases ('Handles both "set up a promotional SMS campaign"...') read as scope examples rather than trigger conditions, so completeness is capped at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage — 'marketing', 'promotional messaging', 'campaign', 'SMS', 'Segment', 'multi-channel engagement' — but a few natural terms users would say are missing (bulk SMS, mass email, WhatsApp, drip campaign, text blast).

4 / 5

Distinctiveness Conflict Risk

Clear niche (Twilio promotional/marketing messaging planning) with distinct triggers; minor overlap risk with transactional Twilio messaging skills that share SMS/WhatsApp keywords.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/twilio-developer-kit/skills/twilio-marketing-promotions-advisor/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.