putervision/behavior-mcp / .agents/skills/behavior-mcp
behavior-mcp
VerifiedTeaches 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
- Define or Load Behavior: Call
load_behaviorwithaction: "load"to inject and start tree execution. - Register Reactive Triggers: Configure emergency preemption using
register_triggerwith priority and cooldown guards. - Monitor Telemetry: Poll execution health, tick rates, and active traversal nodes with
get_status. - Runtime Blackboard: Read and mutate execution variables via
manage_blackboard. - Safety Guardrails: Immediately halt or pause rogue states using
abort_behavior.
3. Complete 10 Consolidated MCP Tools Reference
| Tool Name | Key Actions | Key Parameters | Description |
|---|---|---|---|
load_behavior | load, unload, swap | behavior_name, behavior_version, parameters, intention_id | Hot-swap, inject, or initialize behavior tree instances in browser runtime. |
set_parameters | set, get, reset | execution_id, parameters | Dynamically update or query execution parameters for the active tree. |
get_status | current, history, tree_state | execution_id, limit | Query active behavior status, current node path, tick count, duration, and errors. |
abort_behavior | abort, pause, resume | execution_id, reason | Immediately halt, pause, or resume execution and disengage active inputs. |
register_trigger | register, list | name, condition_type, priority, cooldown_ms, behavior_name | Configure reactive interrupt triggers with priority preemption and cooldowns. |
replay_recording | capture, list | recording_id, execution_id, frames, name | Capture or replay deterministic browser action sequences with adaptive timing. |
get_metrics | current, history, aggregate, compare | execution_id, behavior_name, limit | Retrieve execution telemetry, tick durations, stuck events, and statistics. |
manage_behaviors | register, list, get | name, version, tree, tree_json, description | CRUD operations for immutable JSON behavior trees with SHA-256 tree hash verification. |
manage_blackboard | get, set | execution_id, key, value | Read or write shared behavior tree blackboard state variables. |
manage_runtime_db | stats, audit, snapshot, diff, restore | action, name, description | Database maintenance, diagnostics, and SHA-256 Merkle audit verification. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 468k | Updated | Claude CodeCodex | Verified | Install |
| 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: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |