CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

security-guidance

Security-first development guidance based on OWASP ASVS (Application Security Verification Standard). Use this skill automatically when planning or implementing any code that touches user input, authentication, data persistence, network communication, file I/O, cryptography, or access control. This skill ensures all generated code adheres to industry-standard security practices with explicit references to applied guidance.

60

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/code-security-skills/skills/security-guidance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-structured ASVS reference index with a clear, disciplined read-apply-cite workflow and a good escalation policy. Its main weaknesses are that the entire detailed-guidance layer it depends on is missing from the bundle (breaking both actionability and navigation) and that there is no final checkpoint verifying that all matched requirements were applied and cited.

Suggestions

Ship the referenced `data/asvs/V*.md` files with the skill (or provide fallback guidance for when a reference file is missing), since step 2 of the workflow currently instructs reading files that do not exist in the bundle.

Add a final workflow step that verifies every section matched in step 1 has been applied and cited before completing the plan or code, closing the validation loop.

Trim the per-section intro sentences that restate the section titles and factor the repeated 'See `data/asvs/...` pointer line into a single stated convention to cut the index's token footprint.

DimensionReasoningScore

Conciseness

The body is a uniform trigger index with no concept explanations Claude already knows and almost no padding — every entry is functional. It stays at 4 rather than 5 because each section carries an intro sentence that largely restates the section title (e.g., 'Architectural requirements for the order and placement of encoding...'), and the 'See `data/asvs/...` for detailed guidance' line is repeated verbatim ~80 times, which could be tightened.

4 / 5

Actionability

The workflow steps are concrete ('Cite applied requirements inline' with the example `// ASVS 6.2.4: password checked against top-3000 list`, 'Default to the most secure option', 'Apply all Level 1 requirements as a minimum baseline'), but the central step — 'Read the full reference file listed at the end of its index entry' — points at `data/asvs/V*.md` files that are not present in the skill bundle, so the core read-apply-cite loop cannot actually be executed as written. This is a key-details gap, not a minor one, which rules out 4.

3 / 5

Workflow Clarity

The 4-step workflow (identify → read → apply → cite) is clearly sequenced, with sensible defaults and an explicit error-recovery path ('stop and flag the gap... Do not guess or paraphrase guidance — escalate instead') plus a fallback for an empty index. It falls short of 5 because there is no closing validation step confirming that every matched section was actually applied and cited before the plan or code is delivered.

4 / 5

Progressive Disclosure

The index is well organized with clearly signaled, one-level-deep pointers ('See `data/asvs/V1.2.md` for detailed guidance'), which would fit anchor 5's structure. However, none of the ~80 referenced files exist in the bundle (no `data/`, `references/`, `scripts/`, or `assets/` directories are present), so navigation breaks at the point of use — a defect larger than anchor 4's 'minor organization gaps.'

3 / 5

Total

14

/

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: third-person, concise, with an explicit 'use when' clause enumerating concrete security-sensitive triggers and a clearly named domain standard. Its only notable weakness is that the capability statement is a general guarantee rather than a list of several specific concrete actions.

DimensionReasoningScore

Specificity

It names the domain concretely ('Security-first development guidance based on OWASP ASVS (Application Security Verification Standard)') and gives 1-2 actions ('ensures all generated code adheres to industry-standard security practices with explicit references to applied guidance'), but the actions are stated as guarantees rather than a list of several specific concrete operations. That matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') and falls short of anchor 4's 'lists several specific actions.'

3 / 5

Completeness

It explicitly answers both questions: what it does ('Security-first development guidance based on OWASP ASVS... ensures all generated code adheres to industry-standard security practices with explicit references to applied guidance') and when to use it ('Use this skill automatically when planning or implementing any code that touches user input, authentication, data persistence, network communication, file I/O, cryptography, or access control'). The 'when' clause uses concrete, enumerated trigger phrases, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'user input, authentication, data persistence, network communication, file I/O, cryptography, or access control' are terms users actually say, and 'security', 'OWASP ASVS', and 'security practices' are present. A few natural terms users would commonly use are missing (e.g., 'vulnerability', 'encryption', 'secrets', 'login/session', 'TLS', 'injection'), which keeps it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Anchoring to a specific standard (OWASP ASVS) gives it a clear niche with distinct security triggers, so it is mostly distinguishable from generic coding or review skills. It stays at 4 rather than 5 because the trigger set ('any code that touches user input... file I/O') is deliberately broad and would overlap with general secure-coding or code-review skills in edge cases.

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

skill_md_line_count

SKILL.md is long (997 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

OWASP/secure-agent-playbook

Path

plugins/code-security-skills/skills/security-guidance/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.