CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

twilio-security-hardening

Secure Twilio applications against common attacks. Covers credential management (API keys vs auth tokens), request validation (webhook signature verification), PCI DSS compliance, HIPAA account requirements, SMS pumping prevention, geo-permissions, and account isolation patterns. Use this skill when developers are building or deploying Twilio apps.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

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.

A dense, well-structured security reference with executable code and a properly sequenced rotation workflow including a delete-only-after-verify checkpoint. Its main weaknesses are minor redundancy in the Common Mistakes recap, one underspecified code example (missing body-parser setup), and inline compliance detail that would fit better in separate reference files.

Suggestions

Complete the webhook validation example by including the body-parser/express.raw middleware setup that validateRequest depends on, since URL/body handling is listed as a common mistake but the code itself is incomplete.

Trim the "Common Mistakes" section or fold it into the relevant sections to remove recap redundancy.

Consider moving the PCI DSS and HIPAA detail into a one-level-deep reference file (e.g. compliance.md) with the body keeping only the irreversible-PCI-mode warning and sub-account guidance.

DimensionReasoningScore

Conciseness

Efficient format throughout — comparison tables ("Auth Token | Full account access | Only by rotating..."), terse bullets, and code without explaining concepts Claude already knows. Anchor 4 rather than 5 because of trimmable redundancy: the "Common Mistakes" section recapitulates earlier sections ("Auth Token in code", "PCI Mode on main account", "No geo-permissions") and the SMS-pumping impact paragraph is prose-heavy ("Incidents can climb into tens of thousands of dollars...").

4 / 5

Actionability

Mostly executable guidance: a concrete Node.js validateRequest snippet, a Python recording-pause call, a complete <Pay> example, Console URLs, and a specific 4-layer defense list. Not anchor 5 because the signature-validation example omits the body-parser/express.raw setup that this exact API requires to work — a minor but real gap.

4 / 5

Workflow Clarity

The credential rotation workflow is a clear 4-step sequence ("Create secondary → Operationalize → Promote → Delete old primary") with a verify-before-delete checkpoint, and webhook validation is backed by runnable code. Anchor 4 rather than 5 because the checkpoints lack detail — "verify all traffic uses the new credential" gives no method for verification, and there is no error-recovery loop.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent, so nothing is mis-filed), and the body is well-sectioned with a clear "Next Steps" navigation section. Anchor 4 rather than 5 because at ~150 lines the PCI/HIPAA compliance and fraud-prevention details could be split into one-level-deep reference files instead of fully inlined; it is well above the inline-bloat level of 3.

4 / 5

Total

16

/

20

Passed

Description

80%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 description: third-person, specific, and comprehensive across the Twilio security domain, with an explicit Use-when clause. The when clause is broader than the skill's security scope, and a few natural trigger synonyms (fraud, toll fraud, OTP) are absent.

Suggestions

Tighten the when clause to security-specific triggers, e.g. "Use when securing Twilio apps, validating webhooks, preventing SMS pumping/toll fraud, or addressing PCI DSS or HIPAA requirements".

Add natural synonyms users would say such as "toll fraud", "OTP fraud", and "leaked credentials" to improve trigger coverage.

Consider signaling scope boundaries vs. sibling compliance skills to reduce overlap risk.

DimensionReasoningScore

Specificity

"Secure Twilio applications against common attacks" plus seven named concrete coverage areas ("credential management (API keys vs auth tokens)", "request validation (webhook signature verification)", "PCI DSS compliance", "HIPAA account requirements", "SMS pumping prevention", "geo-permissions", "account isolation patterns") gives comprehensive, specific coverage matching the 5 anchor. Fits 5 rather than 4 because no major capability area of the domain is omitted; it is not below 5 since the actions are concrete rather than minor-gap listings. Third-person voice throughout, so no voice penalty applies.

5 / 5

Completeness

Explicitly answers both: what ("Covers credential management... account isolation patterns") and when ("Use this skill when developers are building or deploying Twilio apps"). The when clause is present but broad — it would match any Twilio build/deploy question rather than security-specific triggers — fitting anchor 4's "'when' could be more explicit or specific" instead of 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: "Twilio", "webhook signature verification", "PCI DSS", "HIPAA", "SMS pumping", "API keys", "auth tokens". A few natural synonyms are missing ("toll fraud", "OTP fraud", "leaked credentials", "compliance"), so it matches anchor 4 rather than the comprehensive-synonym coverage of 5, and is well above the sparse keyword level of 3.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Twilio security hardening) with distinct triggers unlikely to fire for unrelated skills. Minor overlap risk with closely related sibling skills the body itself references (twilio-iam-auth-setup, twilio-compliance-traffic, twilio-account-setup), which matches anchor 4 rather than the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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-security-hardening/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.