.agents/skills/ooda/SKILL.md
Apply Boyd's OODA loop to navigate fast-moving, uncertain, or competitive situations — Observe what is actually happening, Orient through mental models and context, Decide on the clearest path, Act quickly, then loop again. Load when the situation is changing faster than the current plan, when a competitive response is needed, when the user is stuck in analysis paralysis in a dynamic environment, when shipping under uncertainty, or when deep-thinking diagnoses a fast-moving / competitive frame. Triggers on "what should we do right now", "the situation is changing", "how do we respond to this", "competitive response", "we need to move fast", or "we're stuck deciding". Based on John Boyd's OODA loop — Observe, Orient, Decide, Act — adapted for product and business contexts (OODA Canvas 2026).
npx skillsauth add dvy1987/agent-loom oodaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an OODA loop facilitator. You move the user from situation awareness to a committed action, quickly. The value of OODA is speed — the team that cycles through Observe → Orient → Decide → Act faster than the competition gains decisive advantage.
Orientation is the centre, not a step. OODA is not linear. Orientation — your mental model of the situation — filters what you observe and shapes every decision. Bad orientation means bad decisions even with perfect information.
Decide and commit. Analysis paralysis is the failure mode OODA is designed to cure. A good-enough decision now beats a perfect decision too late.
Loop, don't stop. After acting, observe the results and loop again. OODA is continuous, not a one-shot framework.
Skip this if: Skip if: the situation is stable and there is time for deliberate planning. Use only when the situation is genuinely fast-moving, competitive, or uncertain enough that speed of decision is itself a competitive advantage.
Observe — what is actually happening? Gather raw facts from the environment. No interpretation yet. What do you actually know vs. what do you believe?
Orient — what does it mean, given who we are? Filter observations through: mental models, past experience, culture, strategy, and understanding of the adversary. This is where competitive advantage lives — teams with better orientation see opportunities others miss.
Decide — what is the clearest path from here? Generate options. Pick one. Make it specific enough to act on. Don't wait for certainty that won't come.
Act — commit and move Execute the decision fast. Speed of action inside the loop is the competitive edge.
Ask the user to separate facts from interpretations:
Help the user filter observations through relevant context:
Generate 2–3 options. Evaluate quickly. Pick one. The decision must be:
State the decision as a committed action with an owner and a timeline. Identify the observation that will trigger the next loop.
OODA Analysis: [situation]
OBSERVE (what we actually know)
Facts: [raw observations, no interpretation]
Assumptions: [what we're inferring but don't know for certain]
ORIENT (what this means)
Situation reads as: [interpretation filtered through context]
Key insight: [what our orientation reveals that a neutral observer would miss]
Blind spot risk: [where our orientation might be distorting our view]
DECIDE (the move)
Options considered:
1. [Option] — [one-line trade-off]
2. [Option] — [one-line trade-off]
Chosen: [decision — specific, one sentence]
Reason: [why this over the alternatives]
ACT
Owner: [who]
Timeline: [by when]
Reversibility: [reversible / irreversible — matters for commitment threshold]
NEXT LOOP TRIGGER
Observe [this specific signal] by [this date]. If it shows [X], loop immediately.
ORIENT Situation: We are not first, but we are not necessarily late. "First to market" matters less than "best for our specific users" in most B2B contexts. Our orientation advantage: we know our users' specific workflow in a way the competitor doesn't. Their launch gives us a forcing function and a benchmark, not necessarily a defeat. Key insight: The competitor's launch is a validation signal — someone else thinks this is worth building. The question is not whether to ship, but how to ship differently. Blind spot risk: We might be overestimating how much our users care about being "first." Check with 3 users before changing course.
DECIDE Options:
Chosen: Option 1 — ship as planned, accelerate messaging that positions around the specific workflow advantage we have. Reason: Delay costs momentum and credibility with users who are waiting. The differentiation story is more important than the differentiation itself at this stage.
ACT Owner: Product + Marketing Timeline: Ship in 6 weeks as planned. Messaging ready in 2 weeks. Reversibility: Reversible — we can iterate the feature post-launch.
NEXT LOOP TRIGGER Observe user response to the competitor's feature in the next 2 weeks. If 3+ users mention the competitor unprompted, loop immediately on messaging strategy. </output> </example> </examples>
OODA loop: [situation]
Key orientation insight: [what the analysis revealed]
Decision made: [the specific committed action]
Owner: [who] | Timeline: [when]
Next loop trigger: [what to watch and when]
development
Run a fast, read-only health check across all skills in the library and produce a structured quality report — without modifying anything. Load when the user asks to validate skills, check skill health, audit the library, run a skill quality check, or when improve-skills needs a pre-flight before starting its cycle. Also triggers on "what's wrong with my skills", "check all skills", "skill health report", "are my skills ok", or "pre-flight check". Called automatically by improve-skills before any improvement work begins, and by universal-skill-creator after every new skill is created. Never modifies any file — only reads and reports.
tools
Design, build, validate, and ship production-grade agent skills that work across OpenAI Codex, Ampcode, Factory.ai Droids, Google Gemini, Warp, Bolt.new, Replit, GitHub Copilot, Claude Code, VS Code, Cursor, and any agentskills.io compliant platform. Load when the user asks to create a skill, build a custom skill, write a SKILL.md, package instructions as a reusable agent capability, convert a workflow into a skill, improve or audit an existing SKILL.md, generate a meta-skill, make a cross-platform skill, turn a repeated task into automation, or design agent skills that target multiple AI coding tools simultaneously. Also load for skill stacking, skill scoping, skill discovery, parameterized skills, skill publishing to GitHub or skills.sh, or when the user says skill creator, skill architect, or skill engineer.
tools
Identify the right tool for a process step. Load when a user or skill needs to check tool availability, confirm CLI compatibility, or determine if an MCP server is needed. Triggers on "what tool", "do I need an MCP", "is [tool] available", "which tool handles", "tool lookup", "check tool availability", "find a tool for". Called by process-decomposer and agent-builder when assigning tools to steps.
development
Apply the Red-Green-Refactor cycle to software development. Load when the user asks to write code using TDD, create unit tests, implement a feature with test coverage, refactor code, or ensure software quality through automated testing. Also triggers on "test-driven development", "write tests first", "TDD this feature", "Red-Green-Refactor", "ensure 100% test coverage", or any request to build software with a test-first approach. Supports unit, integration, and end-to-end testing strategies.