⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

pz-director

@starbugmolt⭐ 2 stars

SIMON's Project Zomboid Build 42 radio director skill. Discord-first in-world GM with survivor memory, narrative arcs and researched lore.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 2 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

pz-director

SIMON's Project Zomboid Build 42 radio-director skill. Discord-first; RCON is inactive.

Authority

SKILL.md is the authoritative operational/personality contract. Keep model-facing behavioral rules there rather than creating competing prompts or concrete example lists in this README.

Hardened runtime split

  • scripts/simon_radio_listener.py — fast player-facing dialogue; the model never chooses mutations. simon_supply.py may separately perform a verified occasional/test-mode supply gift.
  • scripts/simon_arc_engine.py — canonical narrative-arc state/lifecycle owner.
  • scripts/pz-console.sh — explicit mutation transport with confirmed relay responses.
  • Python cron triggers — preflight scheduled turns before an LLM/agent exists.

The legacy simon_fast_listener.py implementation has been retired.

Cost invariant

If Python cannot positively prove at least one PZ player is online, scheduled LLM work must not start. The active radio listener also performs a positive-player preflight immediately before direct chat completion.

Discord structure

Project Zomboid Build 42 provides three Discord channel roles:

  • DiscordChatChannel — player chat and SIMON broadcasts;
  • DiscordLogChannel — server log output;
  • DiscordCommandChannel — server-console traffic.

Dedicated normalized log-channel ingestion remains future work; do not assume it is active yet.

Main references

  • SKILL.md — SIMON identity, fast-model guardrails, GM discipline and runtime rules.
  • .env.example — non-secret deployment metadata shape.
  • references/project-zomboid-lore.md — Project Zomboid world/lore knowledge.
  • references/narrative-arcs.md — built-in scenario beats and verified wrapper mutations.
  • references/hardening-review.md — implemented vs remaining hardening work.
  • references/catalogs/ — vanilla and enabled-mod reference data.

Documentation placeholders

Values inside <...> are syntax placeholders only and are never real runtime values. Literal format tokens must not be treated as verified game identifiers.

Generated package

The sibling ../pz-director.skill file is a generated compatibility/archive artifact. Rebuild it whenever this source directory changes so deleted/renamed files and new instructions remain synchronized.

// HOW IT'S BUILT

KEY FILES

skills/pz-director/SKILL.mdREADME.md

// REPO STATS

2 stars