Pilot Game Npc Network Setup

Deploy a living NPC village with 4 agents that communicate autonomously. Use this skill when: 1. User wants to set up a game NPC network with emergent behavi...

Security Scan

The skill's instructions, required binaries, and file writes are coherent with its stated purpose (deploying a 4-agent NPC network); no unrelated credentials, installs, or hidden endpoints are requested — but verify you trust pilotctl/clawhub and the pilot-* packages before running.

Purpose & Capability

The name/description (deploy a multiplayer NPC network) lines up with the runtime instructions: installing pilot-* skills with clawhub, using pilotctl to set hostnames/handshakes/publish events, and writing a manifest. Required binaries (pilotctl, clawhub) are exactly those used in the instructions and are appropriate for the task.

Instruction Scope

Instructions are scoped to installing pilot-* skills, setting hostnames, writing a manifest to ~/.pilot/setups/game-npc-network.json, and performing handshakes/publishes on port 1002. There is no guidance to read unrelated files or access unrelated environment variables. Note: the handshake flow described auto-approves trust when both sides handshake; this is protocol behavior but has security implications (automatic trust establishment among nodes).

Install Mechanism

This is an instruction-only skill with no install spec and no code files; nothing is downloaded by the skill itself. The actual installs are delegated to the user's clawhub tool (clawhub install pilot-...); installing those packages is expected for the skill's purpose but is an out-of-skill action the user should verify.

Credentials

The skill requests no environment variables or credentials. It does instruct installing many pilot-* packages, which may themselves request credentials later, but that behavior is external to this skill and not inconsistent with the stated purpose.

Persistence & Privilege

The skill writes a manifest to a user-scoped path (~/.pilot/setups) and does not request always:true or system-wide modifications. It does not modify other skills' configs directly. The ability for nodes to auto-approve trust via handshakes is noted in the instructions but is part of the protocol rather than a privilege escalation by this skill.

Assessment

This skill appears internally consistent with its goal of deploying a 4-agent NPC network. Before installing or running commands: 1) Verify the provenance of pilotctl, clawhub, and the pilot-* packages (ensure they come from trusted official sources) because the skill delegates installs to those tools. 2) Be aware it will write a manifest to ~/.pilot/setups/game-npc-network.json and instruct services to listen/exchange on port 1002 — review firewall/network segmentation if you don't want these agents reachable on your network. 3) The handshake flow auto-approves trust when both sides handshake; only perform handshakes between endpoints you control or trust. 4) If running on production or sensitive hosts, test in an isolated environment first. If you want stronger assurance, inspect what clawhub will install (package sources and post-install behavior) before proceeding.

Game NPC Network Setup

Deploy 4 agents: npc-villager, npc-merchant, npc-guard, and narrative-director.

Roles

Role	Hostname	Skills	Purpose
npc-villager	<prefix>-npc-villager	pilot-chat, pilot-gossip, pilot-presence, pilot-directory	Social backbone -- farms, gossips, remembers player interactions
npc-merchant	<prefix>-npc-merchant	pilot-escrow, pilot-stream-data, pilot-receipt, pilot-auction	Dynamic shop -- supply/demand pricing, inventory, trade negotiation
npc-guard	<prefix>-npc-guard	pilot-watchdog, pilot-alert, pilot-blocklist, pilot-gossip	Village security -- patrols, threat detection, civilian warnings
narrative-director	<prefix>-narrative-director	pilot-task-router, pilot-consensus, pilot-event-filter, pilot-announce	Story orchestrator -- quests, events, difficulty, narrative coherence

Setup Procedure

Step 1: Ask the user which role and prefix (e.g. darkhollow).

Step 2: Install skills:

# npc-villager:
clawhub install pilot-chat pilot-gossip pilot-presence pilot-directory
# npc-merchant:
clawhub install pilot-escrow pilot-stream-data pilot-receipt pilot-auction
# npc-guard:
clawhub install pilot-watchdog pilot-alert pilot-blocklist pilot-gossip
# narrative-director:
clawhub install pilot-task-router pilot-consensus pilot-event-filter pilot-announce

Step 3: Set hostname and write manifest to ~/.pilot/setups/game-npc-network.json.

Step 4: Handshake: all NPCs ↔ narrative-director, npc-villager ↔ npc-merchant, npc-guard ↔ npc-villager.

Manifest Templates Per Role

npc-villager

{
  "setup": "game-npc-network", "role": "npc-villager", "role_name": "NPC Villager",
  "hostname": "<prefix>-npc-villager",
  "skills": {
    "pilot-chat": "Converse with players and other NPCs.",
    "pilot-gossip": "Spread and receive rumors across the village.",
    "pilot-presence": "Broadcast location and activity state.",
    "pilot-directory": "Look up other NPCs by role or name."
  },
  "handshakes_needed": ["<prefix>-narrative-director", "<prefix>-npc-merchant", "<prefix>-npc-guard"]
}

npc-merchant

{
  "setup": "game-npc-network", "role": "npc-merchant", "role_name": "NPC Merchant",
  "hostname": "<prefix>-npc-merchant",
  "skills": {
    "pilot-escrow": "Hold trade value until both parties confirm exchange.",
    "pilot-stream-data": "Stream real-time price feeds to the narrative director.",
    "pilot-receipt": "Issue trade receipts for completed transactions.",
    "pilot-auction": "Run competitive bidding when multiple buyers want scarce goods."
  },
  "handshakes_needed": ["<prefix>-narrative-director", "<prefix>-npc-villager"]
}

npc-guard

{
  "setup": "game-npc-network", "role": "npc-guard", "role_name": "NPC Guard",
  "hostname": "<prefix>-npc-guard",
  "skills": {
    "pilot-watchdog": "Monitor village perimeter for threats.",
    "pilot-alert": "Raise alarms and broadcast threat levels.",
    "pilot-blocklist": "Maintain a list of banned or hostile entities.",
    "pilot-gossip": "Share threat intelligence with other guards and NPCs."
  },
  "handshakes_needed": ["<prefix>-narrative-director", "<prefix>-npc-villager"]
}

narrative-director

{
  "setup": "game-npc-network", "role": "narrative-director", "role_name": "Narrative Director",
  "hostname": "<prefix>-narrative-director",
  "skills": {
    "pilot-task-router": "Route quests and objectives to the right NPCs.",
    "pilot-consensus": "Coordinate multi-NPC decisions (festivals, evacuations).",
    "pilot-event-filter": "Filter and prioritize incoming NPC state reports.",
    "pilot-announce": "Broadcast world events to all village NPCs."
  },
  "handshakes_needed": ["<prefix>-npc-villager", "<prefix>-npc-merchant", "<prefix>-npc-guard"]
}

Data Flows

• npc-villager -> narrative-director : villager state, mood, gossip (topic: villager-state)
• npc-merchant -> narrative-director : economy state, stock levels, price trends (topic: economy-state)
• npc-guard -> narrative-director : threat reports, patrol status (topic: threat-report)
• narrative-director -> npc-villager : story events, quest injections (topic: story-event)
• narrative-director -> npc-merchant : economy events, price shocks (topic: economy-event)
• narrative-director -> npc-guard : threat alerts, patrol orders (topic: threat-alert)
• npc-villager <-> npc-merchant : trade requests, material orders (topic: trade-request)
• npc-guard -> npc-villager : civilian warnings, evacuation orders (topic: civilian-warning)

All flows use port 1002 (event stream).

Workflow Example

# Villager shares daily state:
pilotctl --json publish <prefix>-narrative-director villager-state '{"mood":"worried","activity":"hiding wheat stores","gossip":"strangers seen near east road"}'

# Narrative director triggers a festival to boost morale:
pilotctl --json publish <prefix>-npc-villager story-event '{"event":"harvest_festival","directive":"prepare_feast","quest_hook":"collect_rare_ingredients"}'
pilotctl --json publish <prefix>-npc-merchant economy-event '{"event":"harvest_festival","effect":"food_prices_drop","directive":"stock_ale_and_decorations"}'
pilotctl --json publish <prefix>-npc-guard threat-alert '{"event":"harvest_festival","orders":"increase_night_patrol","note":"large crowds expected"}'

# Guard spots trouble during the festival:
pilotctl --json publish <prefix>-narrative-director threat-report '{"threat":"pickpocket_ring","severity":"low","location":"market_square"}'
pilotctl --json publish <prefix>-npc-villager civilian-warning '{"message":"Watch your coin purses near the market stalls.","urgency":"low"}'

# Merchant adjusts prices after a supply disruption:
pilotctl --json publish <prefix>-narrative-director economy-state '{"iron_stock":0,"price_change":"iron_unavailable","reason":"supply_route_raided"}'

# Villager trades surplus wheat for potions before trouble hits:
pilotctl --json publish <prefix>-npc-merchant trade-request '{"offering":"wheat","quantity":8,"seeking":"healing_potion","quantity_needed":3}'

Dependencies

Requires pilot-protocol skill, pilotctl binary, clawhub binary, and a running daemon.