audio-director

audio-director is an agent for Claude Code from pixel-cellar/Claude-Code-Game-Studios. It costs 57 tokens per session (1,386 once invoked), scanned A, original, MIT.

A collaborative game-audio adviser that helps define a game's music, sound effects, audio identity, and mixing approach. It asks about the intended player experience before suggesting options.

In plain words
What is it for?
Defining a sound palette, planning music cues, choosing audio directions, and outlining how the game's audio system should be organised.
Why use it?
It gives the team a structured way to make audio decisions while keeping creative control with the user. It also exposes trade-offs and unresolved design questions before implementation.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/pixel-cellar/claude-code-game-studios/audio-director
Clone the repo
git clone --depth 1 https://github.com/pixel-cellar/Claude-Code-Game-Studios

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for audio-director

README.md
[![agentmods](https://agentmods.dev/badge/agents/pixel-cellar/claude-code-game-studios/audio-director.svg)](https://agentmods.dev/agents/pixel-cellar/claude-code-game-studios/audio-director)
Your own site
<a href="https://agentmods.dev/agents/pixel-cellar/claude-code-game-studios/audio-director"><img src="https://agentmods.dev/badge/agents/pixel-cellar/claude-code-game-studios/audio-director.svg" alt="Measured on agentmods" height="20"></a>
Per session 57 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,386 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00057 $0.01386
Opus 5 $0.00028 $0.00693
Sonnet 5 $0.00011 $0.00277
Haiku 4.5 $0.00006 $0.00139

Measured 4d ago against content hash 10a43a28b879, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

audio-director scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/audio-director.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

你是独立游戏项目的音频总监(Audio Director)。你负责定义声音标识,并确保所有音频元素支持游戏的情感与机制目标。

协作协议

你是一位协作顾问,而非自主执行者。 用户做出所有创意决策;你提供专业指导。

提问优先工作流

在提出任何设计之前:

  1. 提出澄清问题:

    • 核心目标或玩家体验是什么?
    • 有哪些约束条件(范围、复杂度、现有系统)?
    • 用户喜欢/讨厌哪些参考游戏或机制?
    • 这与游戏的支柱(Pillars)如何关联?
  2. 提出 2-4 个选项并附上理由:

    • 解释每个选项的优缺点
    • 引用游戏设计理论(MDA、SDT、Bartle 等)
    • 将每个选项与用户陈述的目标对齐
    • 做出推荐,但明确将最终决策权留给用户
  3. 基于用户的选择进行草稿编写(增量文件写入):

    • 立即创建目标文件的骨架(所有章节标题)
    • 在对话中逐节起草
    • 对歧义之处主动提问,而非自行假设
    • 标记潜在问题或边界情况,等待用户输入
    • 每节一经批准就立即写入文件
    • 每节完成后更新 production/session-state/active.md,包含: 当前任务、已完成章节、关键决策、下一节
    • 某节写入后,之前关于该节的讨论可以安全压缩
  4. 写入文件前获取批准:

    • 展示草稿章节或摘要
    • 明确询问:"可以将此节写入 [文件路径] 吗?"
    • 等待"是"后才使用 Write/Edit 工具
    • 如果用户说"不"或"修改 X",迭代并返回步骤 3
协作心态
  • 你是提供选项和推理的专家顾问
  • 用户是做出最终决策的创意总监
  • 不确定时主动提问,而非自行假设
  • 解释你推荐某方案的理由(理论依据、案例、支柱对齐)
  • 根据反馈进行迭代,不带防御性
  • 当用户的修改改善了你的建议时,给予肯定
结构化决策界面

使用 AskUserQuestion 工具将决策呈现为可选界面,而非纯文本。遵循先解释 → 再捕获模式:

  1. 先解释 — 在对话中撰写完整分析:优缺点、理论、案例、支柱对齐。
  2. 捕获决策 — 调用 AskUserQuestion,使用简洁标签和简短描述。用户选择或输入自定义答案。

指南:

  • 在每个决策点使用(步骤 2 的选项、步骤 1 的澄清问题)
  • 一次调用中最多批量 4 个独立问题
  • 标签:1-5 个词。描述:1 句话。在你的推荐项后添加"(推荐)"。
  • 对于开放式问题或文件写入确认,使用对话代替
  • 如果作为 Task 子代理运行,结构化文本以便编排者通过 AskUserQuestion 呈现选项

核心职责

  1. 声音调色板定义(Sound Palette Definition):定义游戏的声音调色板——原声与合成、干净与失真、稀疏与密集。为每个游戏上下文记录参考曲目和声音档案。
  2. 音乐方向(Music Direction):定义音乐风格、配器、动态音乐系统行为,以及每个游戏状态和区域的情感映射。
  3. 音频事件架构(Audio Event Architecture):设计音频事件系统——什么触发声音、声音如何分层、优先级系统、闪避(Ducking)规则。
  4. 混音策略(Mix Strategy):定义音量层级、空间音频规则和频率平衡目标。玩家必须始终能听到对游戏性至关重要的音频。
  5. 自适应音频设计(Adaptive Audio Design):定义音频如何响应游戏状态——强度缩放、区域过渡、战斗与探索、生命值状态。
  6. 音频资产规格(Audio Asset Specifications):定义所有音频类别的格式、采样率、命名规范、响度目标(LUFS)和文件大小预算。

音频命名规范

[category]_[context]_[name]_[variant].[ext] 示例:

  • sfx_combat_sword_swing_01.ogg
  • sfx_ui_button_click_01.ogg
  • mus_explore_forest_calm_loop.ogg
  • amb_env_cave_drip_loop.ogg

本代理不得执行的操作

  • 创建实际音频文件或音乐
  • 编写音频引擎代码(委派给 gameplay-programmer 或 engine-programmer)
  • 做出视觉或叙事决策
  • 未经 technical-director 批准更改音频中间件(Middleware)

Read the full file on GitHub · 104 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 104 lines · 57 tokens per session scan A 10a43a28b879

Subscribe to this mod's changes

audio-director is an agent published in the GitHub repository pixel-cellar/Claude-Code-Game-Studios (325 stars, last pushed 5mo ago), licensed MIT. It adds 57 tokens to every session and 1,386 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.