CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

authorizing-api-requests

Use when authenticating or authorizing requests to any Mailtrap API (Email Send, Email Testing/Sandbox, Templates, Contacts, Sending Domains, Suppressions). Use when picking the auth header, choosing token scope, storing tokens safely, or resolving the Mailtrap account_id. Use before writing or generating any Mailtrap API call.

Quality

82%

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

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 well-crafted, actionable conventions document: executable curl examples, exact header and env-var tables, a concrete account_id resolution flow, and a useful mistakes table. Weaknesses are minor — redundancy between 'Hard rules' and 'Common mistakes', placeholder request bodies, and no explicit validate-retry loop or filter example for multi-account token resolution.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no padding explaining what env vars, curl, or secret managers are. However, the 'Common mistakes' table substantially duplicates the 'Hard rules' bullets (hardcoding, CLI flags, committing, pasting into chat, mixing tokens), which is more than trivial trimmable material, so anchor 4 rather than anchor 5.

4 / 5

Actionability

Concrete, executable guidance throughout: exact header forms, a runnable curl + jq one-liner for account_id resolution, response shape with access_levels semantics, and a copy-paste quick reference. Minor gaps — '-d { ... }' placeholder bodies (justified as payloads belong to sibling skills) and no concrete jq filter example for multi-account selection — place it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The token→scope→storage→account_id→call flow is clear in section order, and error-recovery guidance exists (401/403 debugging in 'When to use', the mistakes table with fixes, access_levels checks). Operations are read-only so the destructive-operation validation cap does not apply, but there is no explicit numbered sequence or validate-retry loop for account resolution — anchor 4.

4 / 5

Progressive Disclosure

A self-contained skill with no bundle files, well-organized sections, external doc links signaled one level deep, and no buried references — anchor 4 ('good structure; most content appropriately placed'). It does not qualify for 5 via the under-50-lines exception (the body is ~145 lines), and the account-resolution or mistakes material could arguably live in a reference file.

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: explicit and repeated trigger guidance, concrete enumerated actions, and a distinctive Mailtrap-scoped niche. Its main weakness is that the 'what' side is implied rather than stated, and a few natural synonyms (API key, credentials, 401) are missing.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'picking the auth header', 'choosing token scope', 'storing tokens safely', 'resolving the Mailtrap account_id' — plus an enumerated product surface (Email Send, Testing/Sandbox, Templates, Contacts, Sending Domains, Suppressions). This matches the anchor-5 comprehensive example; the only uncovered action (debugging 401/403) is downstream and does not leave a real gap.

5 / 5

Completeness

The 'when' is explicit and repeated ('Use when…', 'Use before writing or generating any Mailtrap API call'), but the 'what' is only implied through the trigger phrases — there is no statement of what the skill itself provides. This fits anchor 4 (both present, one could be more explicit) rather than anchor 5, which requires both to be clearly and explicitly answered.

4 / 5

Trigger Term Quality

Natural trigger terms are well covered ('authenticating', 'authorizing', 'Mailtrap API', 'token', 'auth header', 'account_id', product names users would say), matching anchor 4's 'good keyword coverage; a few natural terms missing'. It falls short of anchor 5 because common synonyms like 'API key', 'credentials', or error phrases like '401 Unauthorized' are absent.

4 / 5

Distinctiveness Conflict Risk

'Mailtrap' plus the enumerated product surfaces give it a clear niche with minimal conflict against non-Mailtrap skills. However, 'Use before writing or generating any Mailtrap API call' deliberately overlaps with the sibling Mailtrap skills (sending-emails, testing-with-sandbox, etc.), which is intended design but still minor overlap risk — anchor 4 rather than 5.

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

mailtrap/mailtrap-skills

Path

skills/authorizing-api-requests/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.