enemy-ai

Installation
SKILL.md

Enemy AI

This skill owns the brain state machine and transition policy. It does not own sensing geometry, target scoring, attack warnings, or move balance.

Modes

Mode State emphasis
leash-guard guard area, pursue within published leash, then recover
patrol-hunt patrol → investigate/search → combat → recover
ambush hidden/idle → authored reveal → combat
duelist combat spacing and state commitment for one primary opponent
swarm simple local states coordinated by group-tactics

enemy-perception owns sight/hearing/last-known evidence. aggro-table owns AI threat scoring. enemy-kit-balance owns move data. attack-tell owns readable startup.

Transition contract

Publish state IDs and the event/evidence that can enter or leave each state. A transition records its reason (saw_target, lost_target, leash_exceeded, scripted_phase, and so on) so debug output can explain why the brain changed state.

Installs
5
GitHub Stars
13
First Seen
Oct 13, 2026