agentleFS
desertcachedesertcache/agent-os/skills/red-team/SKILL.md

red-team

Skill0 starsChanged 9 months agoMITView on GitHub

Adversarial review: pokes holes in plans, assumptions, and procedures to battle-test them. Use when the user says "red team this", "challenge this", "poke holes", "devil's advocate", "stress test this plan", or "/red-team". Takes a plan, proposal, architecture, or approach and systematically finds weaknesses, blind spots, and failure modes.

28 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use architecture, wizard and 9 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

    architecture

    Create or evaluate an architecture decision record (ADR). Use when choosing between technologies (e.g., Kafka vs SQS), documenting a design decision with trade-offs and consequences, reviewing a system design proposal, or designing a new component from requirements and constraints.

    Also in 3 projects that use this

  • AWSSkill

    wizard

    Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

    Also in 3 projects that use this

  • GoogleSkill

    codebase-design

    Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

    Also in 4 projects that use this

  • GoogleSkill

    domain-modeling

    Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

    Also in 4 projects that use this

  • MicrosoftSkill

    grill-with-docs

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

    Also in 4 projects that use this

  • AWSSkill

    ship

    Finalize dev work on an issue branch — update docs, push, and open a PR.

    Also in 3 projects that use this

  • +3 more from google

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 27 edited versions we read keep these.

  • 8

    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:

    If nothing specific is provided, review the most recent plan or significant decision from the current conversation.

    line 23
  2. Distinctive:

    Before attacking, make sure you understand:

    line 27
  3. Distinctive:

    Run through these lenses systematically.

    line 36
  4. Distinctive:

    Always suggest a fix or mitigation, not just the problem

    line 103
  5. Distinctive:

    Don't nitpick style or naming -- focus on things that actually break

    line 104
  6. Distinctive:

    If the plan is solid, say so.

    line 105
  7. Distinctive:

    Keep it concise -- 10-15 findings max.

    line 106
  8. Distinctive:

    If red-teaming code: focus on logic, not formatting.

    line 108

“Common” is measured: kept by at least 6 in 10 of the 27 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

Red Team -- Adversarial Review

Your job is to be a constructive adversary. Challenge the plan, find the gaps, and make it stronger. Be direct and specific -- vague "what ifs" are useless.

What to Red Team

The user will present one of:

  • A technical plan or architecture
  • A business proposal or strategy
  • A workflow or procedure
  • A code design or API contract
  • A decision with trade-offs

If nothing specific is provided, review the most recent plan or significant decision from the current conversation.

Step 1: Understand the Intent

Before attacking, make sure you understand:

  • What problem is being solved?
  • What are the stated constraints?
  • What does success look like?

State this back in 1-2 sentences so the user can correct any misunderstanding.

Step 2: Adversarial Analysis

Run through these lenses systematically. Skip any that don't apply.

Assumptions

  • What is being taken for granted that might not be true?
  • What dependencies are assumed to be stable?
  • What "obvious" choices might have non-obvious costs?

Failure Modes

  • What happens when things go wrong? (network, API limits, bad input, concurrent access)
  • What's the blast radius of a failure?
  • Are there single points of failure?
  • What's the recovery path?

Edge Cases

  • What inputs, states, or sequences weren't considered?
  • What happens at scale? At zero? At one?
  • What happens if this is used differently than intended?

Complexity & Maintenance

  • Is this over-engineered for the problem?
  • Will future-you understand this in 3 months?
  • What's the operational burden? (monitoring, updates, manual steps)
  • Are there simpler alternatives that get 80% of the value?

Security & Data

  • What can go wrong with untrusted input?
  • Are there secrets, tokens, or PII exposed?
  • What permissions are assumed?

Incentives & Human Factors

  • Will people actually use this as designed?
  • What shortcuts will users take?
  • What's the learning curve?

Step 3: Prioritize

Rank findings by impact and likelihood:

  • Critical: Will definitely cause problems. Must address before proceeding.
  • High: Likely to cause problems. Should address or consciously accept the risk.
  • Medium: Could cause problems in specific scenarios. Worth noting.
  • Low: Theoretical risk. Mention but don't dwell.

Output Format

Red Team Review: {topic}

Understanding: {1-2 sentence restatement of the plan/goal}

## Critical
- {finding}: {why it matters} -> {suggested fix or mitigation}

## High
- {finding}: {why it matters} -> {suggested fix or mitigation}

## Medium
- {finding}: {brief note}

## Low
- {finding}: {brief note}

---
Verdict: {one-line overall assessment -- is this solid with minor fixes, or does it need a rethink?}

Rules

  • Be specific and actionable -- "this might fail" is useless, "X will fail when Y because Z" is useful
  • Always suggest a fix or mitigation, not just the problem
  • Don't nitpick style or naming -- focus on things that actually break
  • If the plan is solid, say so. Don't manufacture problems to seem thorough
  • Keep it concise -- 10-15 findings max. If you have more, prioritize harder
  • The goal is to make the plan stronger, not to kill it. Be an ally who happens to be adversarial
  • If red-teaming code: focus on logic, not formatting. Focus on runtime behavior, not readability

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.