CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

api-audit

Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023). Use when the user mentions 'API security,' 'API audit,' 'BOLA,' 'broken object level authorization,' 'BFLA,' 'function-level authorization,' 'mass assignment,' 'API rate limiting,' 'GraphQL security,' 'REST security,' 'API authentication,' 'API authorization,' 'excessive data exposure,' or needs to review API endpoints for security weaknesses.

Quality

88%

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

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

An exceptionally actionable audit skill with a strictly sequenced workflow, validation gates at every phase, and copy-paste-ready paired-evidence commands. Its weaknesses are minor: duplicated authorization-boundary guidance between two sections and a few bundle files not directly navigable from the entry document.

Suggestions

Deduplicate the Authorization and Boundaries sections — both state the test/staging-instance authorization gate and the no-live-production-PoC rule; keep one canonical statement and cross-reference it.

Link references/orchestration.md and references/to-sarif.mjs directly from the body (e.g., from the verification pass and the CI wiring sections) so every bundle file is reachable one level from SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense with high-signal audit patterns (exact grep strings like "jwt.verify", "Bearer ${process.env", concrete ORM queries) with almost no explanation of concepts Claude already knows, but the Authorization section and the Boundaries section repeat the test/staging-instance gate and no-production-PoC rule nearly verbatim, and a few framing sentences ("The #1 API vulnerability by exploitation frequency") could be trimmed — anchor 4's "minor instances that could be trimmed."

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste-ready paired curl PoC commands (baseline vs. attack, only the token differing), specific grep patterns per category, runnable validators ("node references/validate-findings.mjs findings.json"), a complete report template, and concrete runtime fix-verification steps ("hit the endpoint at 10× the configured rate; observe 429 not 200") — an exact anchor 5 match.

5 / 5

Workflow Clarity

"Run in order. Do not skip to the checklist" is backed by seven numbered phases with explicit validation checkpoints at every stage — coverage ledger before any check ("a bare 'A01 clean' line must never stand in for routes nobody read"), a mandatory refutation pass before reporting, a coverage critic before rendering, and findings.json validated before prose — matching anchor 5's sequence plus feedback loops plus checklist.

5 / 5

Progressive Disclosure

Detailed playbooks are well-signaled one-level-deep links with descriptive context ("For the full playbook ... see references/graphql.md"), and all 8 files cited from the body exist in references/, but orchestration.md, to-sarif.mjs, and the two schema files are only reachable through other reference files (verification.md links to orchestration.md), creating mild second-level chains and entry-point gaps — anchor 4's "minor organization gaps."

4 / 5

Total

18

/

20

Passed

Description

83%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 with an explicit what/when structure and a rich, domain-specific trigger vocabulary that pairs acronyms with their expansions. The remaining gaps are a few missing natural synonyms (notably IDOR) and the absence of any disambiguation from closely related codebase-wide audit skills on the generic triggers.

Suggestions

Add "IDOR" (and common phrasings like "API pentest" or "OWASP API Top 10") to the trigger list — users routinely say IDOR for BOLA-class issues.

Add a short clause distinguishing this per-endpoint, surface-driven audit from a codebase-wide OWASP audit (e.g., "for a focused pass over API endpoints rather than the whole codebase") to reduce overlap on generic triggers like "API security."

DimensionReasoningScore

Specificity

"Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023)" names the domain, three concrete surface types, and a specific standard, but the capability described is a single audit action rather than several distinct actions, so it sits above anchor 3 but short of anchor 5's comprehensive action list.

4 / 5

Completeness

The what is explicit ("Audit REST, GraphQL, and RPC APIs against the OWASP API Security Top 10 (2023)") and the when is explicit with concrete trigger phrases ("Use when the user mentions 'API security,' 'API audit,' ... or needs to review API endpoints for security weaknesses") — an exact anchor 5 match.

5 / 5

Trigger Term Quality

Thirteen quoted triggers give strong natural coverage with acronym-expansion pairs ("BOLA," "broken object level authorization," "BFLA," "function-level authorization," "mass assignment," "API rate limiting," "GraphQL security," "REST security," "excessive data exposure"), but common user phrasings like "IDOR," "API pentest," and "OWASP API" are missing — anchor 4's "good keyword coverage; a few natural terms missing."

4 / 5

Distinctiveness Conflict Risk

Niche triggers like "BOLA," "BFLA," and "mass assignment" are highly distinct, but generic phrases ("API security," "API authentication," "REST security") overlap with closely related security-audit skills and the description does not state its boundary against them, fitting anchor 4's "minor overlap risk with closely related skills."

4 / 5

Total

17

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

briiirussell/cybersecurity-skills

Path

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