# msw-behaviourtree

Builds MSW .behaviourtree files and refreshes a project-specific node spec. Use it to define a behaviour graph with Blackboard variables and node properties.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 9600 installs · ★ 38
- Author: MSW-Git
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-behaviourtree/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/msw-behaviourtree

## What it does

The skill scans `.codeblock` files alongside their `.mlua` counterparts to identify custom nodes, UUIDs, types, and properties. It then assembles the tree graph, adds Blackboard variables, and connects node properties. Check that every referenced custom node appears in the project spec; the skill does not make up a UUID for a missing node.

The `scripts/build-spec.cjs` script generates `.behaviourDocs/bt-spec.md`. Node.js must be on `PATH`; if `Environment/config` is missing, pass `--coreVersion`. The skill also checks parent-child consistency and uses examples and graph rules from `references/` when building the file.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-behaviourtree -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/msw-behaviourtree/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/msw-behaviourtree/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-behaviourtree -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/msw-behaviourtree/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-behaviourtree -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/msw-behaviourtree/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-behaviourtree
```

2. **Manually: put the files in place**
- File: `.github/skills/msw-behaviourtree/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-behaviourtree -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-behaviourtree
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/msw-behaviourtree/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-behaviourtree -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-behaviourtree/SKILL.md

## When to use it
- build an `.behaviourtree` with a defined node graph
- find UUIDs and properties for custom nodes
- wire node properties to Blackboard variables
- refresh the project spec after `.mlua` or `.codeblock` changes

## Example prompts
- Create a `PatrolAndChase` behaviour tree with the graph `Sequence → [Chase, MoveTo]`.
- Scan the project nodes and refresh `.behaviourDocs/bt-spec.md`.
- Add a Blackboard variable named `TargetEntity` and connect it to the `Chase` node property.

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs

From the same set: [msw-git/msw-ai-coding-plugins-official](https://affpapa.org/en/nevibecode/by/msw-git/msw-ai-coding-plugins-official.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md