CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

threat-model

Use when Codex is already in the threat-modeling phase of a security scan, the user explicitly invokes $threat-model, or the user explicitly asks to create, update, or persist a repository threat model. Do not use as the primary trigger for full PR, commit, branch, patch, or repository scans.

63

Quality

79%

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/codex-security/skills/threat-model/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 disciplined, information-dense orchestration skill with concrete artifact formats, filenames, and explicit validation checks, and no wasted tokens on concepts Claude already knows. Its weaknesses are repetition of cache/preservation guardrails, long multi-clause conditional sentences that strain legibility, and reliance on reference files that are not present in this bundle.

DimensionReasoningScore

Conciseness

The body is information-dense and free of concept explanations, assuming Claude's competence throughout. Guardrail rules repeat across steps ("neither read nor replace the shared cache" in step 1 vs. "does not publish it to that shared cache" in step 5; supplied-model preservation in steps 1 and 4), matching anchor 4's minor trimmable instances; there is no padding, so it is well above anchor 3.

4 / 5

Actionability

Concrete, executable guidance throughout: exact reference paths, the exact return payload `{ "format": "markdown", "content": "<exact model text>" }`, artifact filenames (threatmodel.md, <scan_dir>/threatmodel.md), and footer fields (Repository, Version). Below anchor 5 because the core generation procedure and storage mechanics are delegated to external references absent from this bundle; above anchor 3 since what is written is specific, not pseudocode.

4 / 5

Workflow Clarity

Five clearly ordered steps with explicit checkpoints (ask when a required input is missing; cache match on Repository/Version lines; step 5's checks for scope, actual runtime boundaries, source evidence, and separation of hypotheses from findings). Below anchor 5 because there is no remediation loop if step 5's checks fail and the long compound-condition sentences in steps 1-2 obscure the mainline sequence; validation is present, so above anchor 3.

4 / 5

Progressive Disclosure

A lean overview delegating storage policy, artifact schema, security guidance, and model generation to four one-level-deep references, each signaled at its point of need. Below anchor 5 because the referenced files sit outside the skill directory (../../references/) and are absent from the bundle so cannot be verified, and the dense conditional logic in steps 1-2 is inline content that could itself live in a reference; above anchor 3 because the split is appropriate and references are clearly signaled.

4 / 5

Total

16

/

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 highly targeted, well-protected trigger description with excellent when-guidance and distinctiveness. Its main weakness is that the skill's capability (the "what") is only implied through trigger phrasing, which caps specificity and completeness.

Suggestions

State the capability explicitly before the triggers, e.g., "Creates, updates, and persists repository-scoped security threat models as standalone Markdown documents. Use when ..." — this would raise both specificity and completeness.

Briefly name what a generated model covers (architecture, trust boundaries, security-relevant failure modes) so users can recognize the skill even when they do not use the exact phrase "threat model".

DimensionReasoningScore

Specificity

The description names the domain and concrete actions ("asks to create, update, or persist a repository threat model") but only inside trigger phrasing, never stating what the skill actually does with the model. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is not 4 because no distinct capability actions are listed, and not 2 because the named actions are concrete and domain-specific.

3 / 5

Completeness

The "when" is explicit and thorough — three positive triggers plus the negative "Do not use as the primary trigger for full PR, commit, branch, patch, or repository scans" — but the "what" is only implied through the trigger clause rather than stated as a capability. Below anchor 5 (requires both explicit); above anchor 3, whose weakness is the inverse (clear what, weak when).

4 / 5

Trigger Term Quality

Natural user terms are present ("threat model", "threat-modeling", "security scan", "$threat-model") alongside routing terms (PR, commit, branch, patch, repository scans). A few natural synonyms (e.g., "attack model", "security analysis") are missing, so it falls short of anchor 5's comprehensive synonym coverage but exceeds anchor 3's missing common variations.

4 / 5

Distinctiveness Conflict Risk

A clear niche (threat-model phase within security scanning) with distinct triggers, a named invocation ($threat-model), and an explicit negative trigger separating it from full scan skills — minimal conflict risk, matching anchor 5.

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/threat-model/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.