orkcore-fsm

What problem does it solve?

This skill helps developers and reviewers quickly understand and work with Orkid's hierarchical finite state machine (HFSM) implementation by mapping concepts to the repository's C++ headers, implementation, tests, and Python bindings.

Core Features & Use Cases

• Shared immutable FsmData definitions and per-entity FsmInstance runtimes with state lifecycle callbacks for enter, exit, and update.
• PredicatedTransition guard conditions, string-to-event hashing, FsmGroup multi-instance coordination, and generateDot visualization for Graphviz.
• Use cases include implementing game object behavior, coordinating groups of agents, writing Python unit tests against the bindings, and producing DOT diagrams for debugging state transitions.

Quick Start

Ask the skill to explain how to create an FsmData, add states and predicated transitions, instantiate FsmInstance, and generate a DOT visualization.