agentleFS
AL-JANEFAL-JANEF/janef-forge/skills/security/threat-model/SKILL.md

threat-model

Skill1 starsChanged 54 days agoMITView on GitHub

Structured STRIDE threat modeling at design time, before code exists: name assets, actors, and trust boundaries, walk Spoofing/Tampering/Repudiation/Information disclosure/Denial of service/Elevation of privilege at each boundary, rate and prioritize, and turn mitigations into build tasks. Use when designing a system, feature, or API or asking what could go wrong. Defensive only.

57 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use vuln-scan, supply-chain-review and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AnthropicSkill

    vuln-scan

    Static source-code vulnerability scan. Reads a target directory (and THREAT_MODEL.md if present), spawns parallel review subagents per focus area, and writes VULN-FINDINGS.json + .md for /triage to consume. Read-only — no building, running, or network. For execution-verified crashes, use vuln-pipeline instead. Use when asked to "scan for vulns", "review this code for security issues", "find bugs in <dir>", or as the step between /threat-model and /triage.

    Also in 5 projects that use this

  • MesteriisSkill

    supply-chain-review

    Reviews lockfiles, installers, provenance, CI permissions, dependency confusion, artifacts, registries, and publishing.

    Also in 3 projects that use this

  • AnthropicSkill

    patch

    Generate candidate fixes for verified security findings. Consumes

    Also in 4 projects that use this

  • mbwsimsSkill

    orbit

    Run for repo-wide or diff-wide readiness sweeps: "/orbit", "/orbit pr", "/orbit deep", "/orbit quick", "audit this project", "project-wide review", "is this PR ready overall", or "combined security, tests, codebase, evolution, and instruction review". Use this for broad multi-system assessment, not for a single-file review or a one-domain question.

    Also in 3 projects that use this

  • mbwsimsSkill

    test-plan

    This skill should be used when the user asks to "plan tests", "what should I test", "what tests do I need", "test plan for", "testing strategy for", "test matrix for", "what cases should I cover", "help me plan tests", mentions "/test-plan", or wants to understand what tests are needed before writing any test code.

    Also in 3 projects that use this

  • Sagargupta16Skill

    dependency-audit

    Audit project dependencies for security vulnerabilities, licensing issues, maintenance health, and optimization opportunities. Use it during regular security audits (monthly or quarterly); before a major release when you want to ensure the dependency tree is clean; when evaluating whether to adopt or replace a dependency; after a security advisory affects one of your dependencies; when your install times or bundle sizes have grown noticeably.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 50 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use it at design time: a new system or service, a new feature touching data or auth, an architecture diagram, a set of API contracts, or …

    line 24
  2. Distinctive:

    Not every category applies to every flow — the discipline is in *asking* each one, then recording the ones that hit.

    line 60
  3. Distinctive:

    Every accepted threat gets one of: a mitigation (a control that reduces it), an acceptance (a documented decision to live with it and why), …

    line 71
  4. Distinctive:

    Keep threats concrete and tied to *this* design, not generic.

    line 100

“Common” is measured: kept by at least 6 in 10 of the 50 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Threat Model

The cheapest security fix is the one made before the code exists. This skill runs a disciplined pass over a design to surface risks early, using STRIDE so the analysis is systematic rather than "whatever we happen to think of."

The core question repeated at every trust boundary: what does an attacker gain by spoofing, tampering, denying, disclosing, disrupting, or escalating here?

When to reach for this skill

Use it at design time: a new system or service, a new feature touching data or auth, an architecture diagram, a set of API contracts, or any "how should we build X?" where X handles sensitive data, money, identity, or multi-tenant access. If the user is still deciding how to build something, this is the moment — cheaper than auditing it later.

The method

1. Establish scope and assets

Name what you're protecting before hunting threats. Identify: the sensitive assets (user data, credentials, money, tenant boundaries, PII), the actors (anonymous users, authenticated users, admins, external services), and the trust boundaries (where data crosses from less-trusted to more-trusted — client→server, service→service, user→tenant). Threats live at trust boundaries; that's where to look hardest.

2. Apply STRIDE at each boundary

For each trust boundary and data flow, walk the six STRIDE categories and ask whether each applies:

  • Spoofing — can an attacker pretend to be someone else? (weak auth, stealable tokens, no service-to-service authentication)
  • Tampering — can data be modified in transit or at rest? (no integrity checks, mutable client-side values trusted by server, missing TLS)
  • Repudiation — can someone deny an action with no trace? (no audit log of sensitive operations)
  • Information disclosure — can data leak? (verbose errors, IDOR, unencrypted storage, over-broad API responses, cross-tenant leakage)
  • Denial of service — can availability be destroyed? (no rate limiting, unbounded queries, expensive operations triggerable by anyone)
  • Elevation of privilege — can a low-privilege actor gain higher rights? (missing authorization checks, insecure direct role assignment, injection leading to code execution)

Not every category applies to every flow — the discipline is in asking each one, then recording the ones that hit.

3. Rate and prioritize

For each identified threat, judge likelihood and impact roughly (high/medium/low each). Focus mitigation effort on high-impact threats first. Don't demand a formal scoring system for a small feature — proportional rigor.

4. Assign mitigations

Every accepted threat gets one of: a mitigation (a control that reduces it), an acceptance (a documented decision to live with it and why), or a transfer (push it to a provider/library). "We'll think about it later" is not an outcome — name the decision.

See references/stride-prompts.md for a fuller set of guiding questions per category, and references/example.md for a worked threat model of a typical multi-tenant API feature.

Output format

Produce a threat model table plus a prioritized mitigation list:

## Threat Model: <feature/system>

### Assets & trust boundaries
- Assets: ...
- Boundaries: ...

### Threats (STRIDE)
| # | Boundary | STRIDE | Threat | Likelihood | Impact | Mitigation |
|---|----------|--------|--------|-----------|--------|------------|
| 1 | ...      | Info disclosure | ... | High | High | ... |

### Priorities
1. <highest-impact threat> → <mitigation> → <owner/when>

Keep threats concrete and tied to this design, not generic. A threat the reader can't act on isn't worth listing.

Handing off to build

A threat model is only useful if its mitigations become work. End by turning the top mitigations into concrete build tasks — the things that must be true in the implementation. This is where threat-model connects to auth-hardening and vuln-audit: the mitigations named here become the checks those skills enforce later.

References

  • references/stride-prompts.md — Expanded question prompts per STRIDE category to drive a thorough pass. Read it when running the analysis.
  • references/example.md — A worked example threat model for a multi-tenant API endpoint, showing the method end to end.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.