Skip to content

putervision/behavior-mcp / .agents/skills/behavior-mcp

behavior-mcp

Verified

Teaches the agent to use the Behavior MCP server for ~60Hz in-browser behavior trees, triggers, and recordings.

Behavior Runtime Engine (behavior-mcp)

This skill provides step-by-step guidance and operational patterns for interacting with @putervision/behavior-mcp with project slug "behavior-mcp".


1. Role in the PuterVision Pentad

  • Workflow State (state-memory-mcp): Persistent task DAGs, decisions, milestones, and blockers.
  • Perception (vision-memory-mcp): Visual layout caching, screenshots, and visual specifications.
  • Spatial World (world-model-mcp): Persistent 3D/2D coordinates, bounding boxes, and topological relations.
  • Strategic Reasoning (agent-reasoning-mcp): Strategic BDI goals, utility scoring, and intention dispatch.
  • Tactical Execution (behavior-mcp): High-frequency (~60Hz) deterministic behavior tree execution directly in browser runtimes with reactive interrupts.

2. Core Operational Sequence

  1. Define or Load Behavior: Call load_behavior with action: "load" to inject and start tree execution.
  2. Register Reactive Triggers: Configure emergency preemption using register_trigger with priority and cooldown guards.
  3. Monitor Telemetry: Poll execution health, tick rates, and active traversal nodes with get_status.
  4. Runtime Blackboard: Read and mutate execution variables via manage_blackboard.
  5. Safety Guardrails: Immediately halt or pause rogue states using abort_behavior.

3. Complete 10 Consolidated MCP Tools Reference

Tool NameKey ActionsKey ParametersDescription
load_behaviorload, unload, swapbehavior_name, behavior_version, parameters, intention_idHot-swap, inject, or initialize behavior tree instances in browser runtime.
set_parametersset, get, resetexecution_id, parametersDynamically update or query execution parameters for the active tree.
get_statuscurrent, history, tree_stateexecution_id, limitQuery active behavior status, current node path, tick count, duration, and errors.
abort_behaviorabort, pause, resumeexecution_id, reasonImmediately halt, pause, or resume execution and disengage active inputs.
register_triggerregister, listname, condition_type, priority, cooldown_ms, behavior_nameConfigure reactive interrupt triggers with priority preemption and cooldowns.
replay_recordingcapture, listrecording_id, execution_id, frames, nameCapture or replay deterministic browser action sequences with adaptive timing.
get_metricscurrent, history, aggregate, compareexecution_id, behavior_name, limitRetrieve execution telemetry, tick durations, stuck events, and statistics.
manage_behaviorsregister, list, getname, version, tree, tree_json, descriptionCRUD operations for immutable JSON behavior trees with SHA-256 tree hash verification.
manage_blackboardget, setexecution_id, key, valueRead or write shared behavior tree blackboard state variables.
manage_runtime_dbstats, audit, snapshot, diff, restoreaction, name, descriptionDatabase maintenance, diagnostics, and SHA-256 Merkle audit verification.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall