CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-finding

Use only when the user explicitly asks to fix and verify a validated or plausible security vulnerability. Do not use for ordinary bug fixes, correctness or design review findings, general validation, or full PR, commit, branch, patch, or repository scans.

65

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

81%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 high-quality process skill: ordered verification gates, an adversarial review stage, and a precise output contract make the workflow unambiguous and self-validating, and it trusts Claude's competence with no conceptual padding. Only minor improvements remain — consolidating repeated scope-discipline rules and providing example artifacts for the workbench stages.

DimensionReasoningScore

Conciseness

The body is dense and procedural and assumes Claude's competence throughout — it never explains basic security, git, or patching concepts — but the scope-discipline rule ('do not broaden into unrelated redesign, cleanup, or sibling findings') is restated across the Patch Contract, Implementation Workflow, Patch Candidate Review, and Hard Rules sections and could be tightened to a single statement. Not 5 due to that repetition; well above 3 since there is no padded or unnecessary conceptual explanation.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: named terminal outcomes ('fixed', 'no_change', 'blocked' and the workbench stage statuses), an exact output checklist, ordered verification gates, and specific delegation assignments with 'fork_turns: "none"'. Not 5 because directives like 'run the smallest high-signal reproduction' and the workbench stage records lack any example commands or a sample report format; not 3 since the guidance is specific and directly executable rather than pseudocode-level.

4 / 5

Workflow Clarity

The workflow is fully sequenced — patch contract, pre-patch investigation, implementation, self-challenge before verification, ordered verification gates, one adversarial review cycle, terminal outcome — with explicit validation checkpoints, feedback loops ('revise the implementation if either exists', confirming reviewer hypotheses before revising, rerunning verification after changes), and a Hard Rules gate that 'fixed' may not be reported until every ordered gate passes. This matches the top anchor's clear sequence, explicit validation, error-recovery loops, and checklist.

5 / 5

Progressive Disclosure

Peripheral policy is correctly split out via well-signaled, one-hop references ('read `../../references/artifact-storage.md` and follow its storage policy', 'resolve it using `../../references/scan-artifacts.md`') and sections are clearly organized. Not 5 because no reference files ship in the bundle to verify those paths resolve, and the specialized 'Workbench Remediation Stages' section is inlined content that applies only to Codex Security workbench requests and could live in its own reference; not 3 because structure is good and references are clearly signaled with stated purposes.

4 / 5

Total

17

/

20

Passed

Description

73%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 tightly scoped, defensively written description with excellent trigger discipline and explicit exclusion of neighboring skills. Its main weakness is that the capability statement ('what') is never made explicit and survives only inside the when-clause, leaving specificity and completeness short of the top anchors.

Suggestions

Lead with an explicit capability statement before the trigger clause, e.g. 'Turns a validated or plausible security finding into a minimal, verified code fix, or proves no change was needed', so the what is stated rather than implied.

Add natural synonym trigger terms such as 'security finding', 'exploit', 'CVE', or 'remediate' to broaden keyword coverage toward the top trigger-term anchor.

Briefly enumerate the concrete actions performed (reproduce through the boundary, patch at the shared enforcement point, run ordered verification gates) to lift capability specificity from one combined action to several specific ones.

DimensionReasoningScore

Specificity

The only capability content is 'fix and verify a validated or plausible security vulnerability' — one combined concrete action in the security-remediation domain, with the rest of the description being trigger scoping rather than capability listing. It is not 2 ('fix and verify' is concrete, not generic) but does not list several specific actions needed for 4.

3 / 5

Completeness

The 'when' is maximally explicit ('Use only when the user explicitly asks...' plus explicit exclusions), and a 'what' is present but only implicitly, embedded inside the trigger clause ('fix and verify a... security vulnerability') rather than stated as a capability. Not 5 because the what is never separately and explicitly stated; not 3 because the when-clause is explicit and the what, while embedded, is discernible.

4 / 5

Trigger Term Quality

Natural terms a user would say are present — 'fix', 'verify', 'security vulnerability', 'bug fixes', 'patch' — giving good keyword coverage. Not 5 because common synonyms and variations such as 'exploit', 'CVE', 'security finding', or 'remediate' are missing; clearly above the 3 anchor's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

'Do not use for ordinary bug fixes, correctness or design review findings, general validation, or full PR, commit, branch, patch, or repository scans' explicitly fences off every adjacent skill category, leaving a clear niche (fixing one validated or plausible security finding on explicit request) with minimal conflict risk — a direct match for the top anchor.

5 / 5

Total

16

/

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

openai/plugins

Path

plugins/codex-security/skills/fix-finding/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.