ooda-loop-state-machine-skill

Organize agent decisions into an OODA loop with ooda-cycle-log.md artifacts.

1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/StepowskiEric/Jerrys-agent-skills --skill ooda-loop-state-machine-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ooda-loop-state-machine-skill
Source: https://github.com/StepowskiEric/Jerrys-agent-skills/tree/main/.agents/skills/execution/ooda-loop-state-machine-skill
Command: npx skills add https://github.com/StepowskiEric/Jerrys-agent-skills --skill ooda-loop-state-machine-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enforces a disciplined decision loop for AI agents operating in dynamic environments, translating the OODA framework into a state-machine protocol to maintain tempo and accuracy.

Core Features & Use Cases

  • Observe, Orient, Decide, Act, and Loop provide a repeatable, bounded-action workflow that gates behavior with diagnostic artifacts.
  • Mandatory artifact: before first action, create ooda-cycle-log.md and update it each cycle to ensure traceability.
  • State Machine structure: five states (Mission Framing, Observe, Orient, Decide, Act) with explicit exit conditions and gating.
  • On-demand artifacts and gates – scripts/references/assets directories may be used to store logs, model updates, and supporting docs as needed.

Quick Start

Initialize the ooda-cycle-log.md and begin the Observe phase to start the loop.

Frequently Asked Questions about ooda-loop-state-machine-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement an OODA loop for AI agents in rapidly changing environments?

An OODA loop for AI agents organizes decision-making into Observe, Orient, Decide, and Act phases, creating bounded, traceable actions. It enforces a mandatory ooda-cycle-log.md to maintain tempo and accuracy in rapidly changing or adversarial environments.

What is a state-machine protocol for agent decision-making?

A state-machine protocol for agent decision-making structures the workflow into five states with explicit exit conditions and gating. This enforces diagnostic artifacts and loop-back re-observation to ensure actions remain bounded and traceable.

How do I start the OODA cycle state machine for my agent?

Start the OODA cycle by initializing the ooda-cycle-log.md file before the first action. Then begin the Observe phase to start the loop, updating this log each cycle to ensure traceability.

Does this OODA loop skill support safety gating for agent actions?

Yes, the OODA loop skill supports safety gating by enforcing mandatory artifacts and gating conditions across its five states. This ensures actions remain bounded and traceable before proceeding through the loop.

When do I need a structured OODA framework for my agent workflow?

You need a structured OODA framework when your agent operates in dynamic or adversarial environments requiring fast, repeatable decision loops. It maintains tempo and accuracy by translating the OODA framework into a state-machine protocol with loop-back re-observation.

What are the limitations of using an OODA state machine for agent safety?

The OODA state machine requires creating and updating an ooda-cycle-log.md file before the first action, adding process overhead. It relies on explicit exit conditions and gating, which may reduce tempo if diagnostic artifacts are not managed efficiently.