CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

security-audit

Security guidance and vulnerability review for codebases, APIs, services, CLI tools, libraries, and daemons. Use for security questions, focused reviews, vulnerability research, security audits, or pen tests. Run the complete workflow only for explicit codebase audit or pen-test requests, full/comprehensive/end-to-end reviews, or requested report artifacts.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./packages/security-audit/skill/SKILL.md

The canonical home for this skill is security-audit in cloudflare/security-audit-skill

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 rigorous, well-sequenced audit workflow with explicit validation checkpoints, defined terminal states, and unusually concrete operational rules (exact keys, statuses, regexes, severity anchors). Its weaknesses are verbosity from repeated budget/reservation rules and inlined procedural detail, and progressive disclosure: heavy content stays in SKILL.md while the referenced companion files and validators are absent from the bundle.

Suggestions

Move the 11-step write-isolation promotion procedure (and the budget reservation algorithm) into a companion file, leaving SKILL.md with a one-paragraph summary and the existing pointer — this serves both conciseness and progressive disclosure.

Consolidate the cost-budget section's three restatements of the reservation rule into one gate specification plus one overrun policy, cutting roughly half of that section.

Ship the referenced companion files (RECONNAISSANCE.md, HUNTING.md, ATTACK-CLASSES.md, VALIDATION-AND-REPORTING.md, report-schema.json, validate-findings.cjs, validate-coverage-ledger.cjs) alongside SKILL.md, and show the exact validator invocation commands in Phase 4 so the validation step is copy-paste executable.

DimensionReasoningScore

Conciseness

The body is dense prescriptive prose without filler or explanations of concepts Claude already knows, but it could be tightened: the cost-budget section restates the reservation logic across three-plus paragraphs ("Reserve critics and validation before hunting", the pre-wave gate, the strict-budget overrun paragraph), and the 11-step write-isolation promotion procedure (fstat/link-count/no-follow detail) is inlined where a summary plus pointer would do. This sits at anchor 3 — mostly efficient, some tightening possible — rather than 2, since there is little true padding or known-concept explanation.

3 / 5

Actionability

Concrete, executable instruction throughout: exact shared-file names (run-metadata.json, findings.json, REPORT.md), exact JSON keys (run_id, source_ref, incomplete_reason: "budget_cannot_fund_reconnaissance_and_reserves"), an agent-ID regex with device-name exclusions, five severity anchors with a stated discriminator, and a two-terminal-state stop rule. Minor gaps keep it from 5: the validator invocations (validate-findings.cjs, validate-coverage-ledger.cjs) are named but never shown as commands, and key operational detail is deferred to companion files.

4 / 5

Workflow Clarity

The six phases are explicitly ordered, each with named companion files, and validation checkpoints are explicit and central: Phase 4 requires schema validation with named validators, Phase 5 adds independent verification, and the run may only end in one of two defined terminal states ("(a) all Phase 6 artifacts are written and both validators pass, or (b) run_status: "incomplete" is recorded"). Budget-exhaustion and validation-exhaustion paths each specify exactly what to mark, record, and report — full feedback loops matching anchor 5.

5 / 5

Progressive Disclosure

Companion files are clearly signaled one level deep at the phase boundaries (RECONNAISSANCE.md, HUNTING.md, ATTACK-CLASSES.md, VALIDATION-AND-REPORTING.md), but two issues hold it at anchor 3: substantial detail that belongs in those companions (the write-isolation promotion procedure, the budget reservation algorithm, the prior-run carry rules) is inlined in SKILL.md, and the referenced companion files, schema (report-schema.json), and validators are not present in the provided bundle — so the navigation the body promises cannot be verified and the skill as shipped reads as a monolithic file with dangling references.

3 / 5

Total

15

/

20

Passed

Description

78%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 explicit what/when structure, third-person voice, and a useful scope guard distinguishing guidance mode from full audit mode. Main weaknesses are slightly generic capability verbs and a couple of missing common synonyms (e.g., "security review", "pentest").

DimensionReasoningScore

Specificity

The description names the domain ("Security guidance and vulnerability review") and target types ("codebases, APIs, services, CLI tools, libraries, and daemons") but offers only two generic actions — guidance and vulnerability review — versus the several concrete actions of anchor 4. It is well above anchor 2 because the actions are stated, not merely the domain.

3 / 5

Completeness

It explicitly answers what it does ("Security guidance and vulnerability review for codebases, APIs, services, CLI tools, libraries, and daemons") and when to use it ("Use for security questions, focused reviews, vulnerability research, security audits, or pen tests"), plus a concrete scoping clause for when the full workflow runs. This matches anchor 5 with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural-term coverage: "security questions", "security audits", "pen test", "vulnerability research", "focused reviews", "full/comprehensive/end-to-end reviews" are phrases a user would naturally say. A few common synonyms are missing (e.g., "security review", "pentest", "secure code review"), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clear security-audit/pen-test niche with distinct triggers, but the broad "security questions" and "focused reviews" phrases create minor overlap risk with closely related code-review or secure-coding skills — anchor 4 rather than 5.

4 / 5

Total

16

/

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

relative_links

Relative link issues: 8 missing

Warning

Total

15

/

16

Passed

Repository

MapleTechLabs/maple

Path

packages/security-audit/skill/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.