CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

security-review

Comprehensive security code review workflow for a target repository, producing a markdown report with findings and recommendations.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./sources/skills/security-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body is efficient, well-sectioned, and gives concrete rule sources, report requirements, and output conventions. Its main weaknesses are a referenced bundle file that does not exist, missing validation checkpoints (rule-load failure, report-write verification), and a couple of vague operational steps (how to load rules, "line by line" review).

Suggestions

Fix the dangling reference: either bundle `Security_Code_Reviewer_Guidelines.md` (e.g. under `references/`) or remove/inline the instruction that points to it.

Add validation checkpoints: what to do if the CodeGuard rules cannot be fetched, and verify the report file was written to `./security_report/` before declaring completion.

Make rule loading executable — specify concrete retrieval (raw.githubusercontent.com URLs or a clone command) — and replace "Review the repository line by line" with a practical traversal strategy (e.g., by entry point, then by module).

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's security knowledge (focus areas are listed as bare terms like "injection flaws, authn/authz, SSRF"), with only minor trimmable redundancy — e.g. "These are mandatory foundational rules that must be loaded for every review" restates the prior bullet, and the output path is explained twice. Not 5: a few sentences could be tightened without losing anything.

4 / 5

Actionability

Concrete guidance includes exact rule-source URLs, an example invocation (`$security-review /path/to/repo`), a fully specified report structure, and a precise output path convention. Not 5: "Load all core security rules from <URL>" gives no mechanism (raw URLs? clone?), and "Review the repository line by line" is not executable guidance for a real repository.

4 / 5

Workflow Clarity

The 3-step sequence (load knowledge base, analyze, report) is clearly ordered, and one checkpoint exists ("If the repo path is missing or unclear, ask the user for it before proceeding"), but other checkpoints are missing. Not 4: there is no validation for failed rule loading (network/missing URL), no check that the report was written successfully, and no guidance on handling an empty or unwritable target.

3 / 5

Progressive Disclosure

Sections (When to use, Inputs, Workflow, Report requirements, Output) are well organized and the body is short, but the body directs the reader to "the `Security_Code_Reviewer_Guidelines.md` file bundled with this skill", and no such file exists anywhere in the skill bundle — a dangling reference that breaks navigation. Not 4: the one referenced bundle file is missing, so the structure cannot be relied on; not 2: the body itself is appropriately sized and does not inline material that belongs in separate files.

3 / 5

Total

14

/

20

Passed

Description

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

The description clearly states what the skill does and its output artifact, but omits any "when to use" trigger guidance and lacks synonym coverage for common security-audit phrasing. It is distinct from most skills but sits close to generic code-review territory.

Suggestions

Add a "Use when..." clause with natural trigger phrases, e.g. "Use when the user asks for a security review, vulnerability audit, or secure-code assessment of a repository."

Include common synonyms such as "vulnerabilities", "security audit", or "threats" so natural user phrasings match the description.

Trim the empty qualifier "Comprehensive" and instead enumerate a couple of concrete capabilities (e.g., severity-ranked findings, remediation guidance).

DimensionReasoningScore

Specificity

"security code review workflow" names the domain and "producing a markdown report with findings and recommendations" gives 1-2 concrete outputs, but coverage of actions is thin and "Comprehensive" is fluff. Not 4: it does not list several specific actions, only the review workflow and its report artifact.

3 / 5

Completeness

The "what" is clear (security code review producing a markdown report with findings and recommendations), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3. Not 4: the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"security code review", "repository", and "findings" are relevant keywords users would plausibly say, but common variations like "vulnerabilities", "audit", "security scan", or "pentest" are missing. Not 4: keyword coverage is not broad enough to be 'good'.

3 / 5

Distinctiveness Conflict Risk

Security-focused code review is a fairly distinct niche with terms unlikely to trigger general document or data skills, though it overlaps with generic code-review and audit skills. Not 5: no explicit trigger phrases establish a fully distinct boundary against those closely related skills.

4 / 5

Total

13

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

cosai-oasis/project-codeguard

Path

sources/skills/security-review/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.