CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

twilio-iam-auth-setup

Set up and manage Twilio authentication credentials: Auth Tokens, API keys (Standard, Main, Restricted), Access Tokens for client-side SDKs, and credential rotation. Use this skill as a prerequisite foundation before making any Twilio API calls.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, well-organized skill body: executable dual-language code throughout, a valuable CANNOT section capturing non-obvious API pitfalls, and clean section navigation. The main gains are trimming the duplicated key-type tables and adding explicit verification steps to the non-rotation workflows.

Suggestions

Consolidate the key-type access/use-case table that appears in both the Overview and the 'API Keys (production)' section into one location to remove redundancy.

Add an explicit validation checkpoint to the rotation and key-replacement flows (e.g., verify a test call with the secondary token before promoting, and confirm the new key works before deleting the old one).

Move grant-type details and restricted-key permission-pattern tables into a reference file to slim the SKILL.md body toward a leaner overview.

DimensionReasoningScore

Conciseness

The body is dense and information-forward — tables, executable snippets, and env-var reference with almost no filler. It is not 5 because the key-type access levels appear twice (Overview table and "API Keys (production)" table) and the "For beginners / vibe-coders" paragraph re-explains leak/rotation rationale Claude could infer; not 3 because the padding is minor, not pervasive.

4 / 5

Actionability

Every section gives copy-paste-ready, executable Python and Node.js code with real env-var names, exact Console paths ("Console > Account > API keys & tokens > Create API key"), concrete policy JSON for restricted keys, magic test numbers, and error codes. Not 4 because there is no missing detail blocking execution of the common cases.

5 / 5

Workflow Clarity

The rotation flow is a clear 4-step sequence with an inline checkpoint ("Once confirmed working, promote the secondary to primary") and a downtime warning, and key replacement follows a safe create → update → delete order. Not 5 because other workflows (e.g., Access Token issuance, restricted-key rollout) lack explicit validation/verification checkpoints and there is no error-recovery loop for the rotation step.

4 / 5

Progressive Disclosure

No bundle files exist; the single SKILL.md is well organized with clear sections (Quickstart, Key Patterns, CANNOT, Next Steps) and well-signaled external doc links and sibling-skill pointers, all one level deep. Not 5 because the ~240-line body inlines material (grant-type details, permission-pattern tables) that could be split into reference files; not 3 because structure and navigation are solid.

4 / 5

Total

17

/

20

Passed

Description

92%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: concrete capability enumeration across all Twilio credential types, an explicit when-to-use clause tied to Twilio API work, and natural trigger terms. Only minor gains possible from adding a few more synonyms.

DimensionReasoningScore

Specificity

The description enumerates concrete actions ("Set up and manage Twilio authentication credentials") across all credential types: "Auth Tokens, API keys (Standard, Main, Restricted), Access Tokens for client-side SDKs, and credential rotation" — comprehensive coverage of the domain's capabilities. Not score 4 because there is no noticeable coverage gap in the action list; not below because the language is concrete, not generic.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is concrete ("Set up and manage Twilio authentication credentials... credential rotation") and the "when" is explicit ("Use this skill as a prerequisite foundation before making any Twilio API calls"). Not 4 because the when-clause is explicit and specific rather than only implied or vague.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Twilio authentication", "Auth Tokens", "API keys", "Access Tokens", "credentials", "rotation" — terms users would actually say. Not 5 because a few natural variations are missing (e.g., "API key secret", "sign-in", "JWT"); not 3 because coverage goes well beyond a single generic term.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Twilio authentication/credential management) with distinct trigger terms, so it is unlikely to fire for unrelated skills. Not 4 because the only conceivable overlap (a sibling twilio-security-hardening skill) is not described here, and the credential-centric scope is unambiguous.

5 / 5

Total

19

/

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-iam-auth-setup/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.