sk-wwise-mcp: Skill for Claude Code

Wwise MCP Global Rules

Always Follow These Rules

• Never use edit servers (objects, containers, pipeline) for read-only tasks — use browse
• Always query before editing — confirm the object exists and check its current state
• When get_wwise_object_info results are large, read the saved output_file — the preview only shows 10 items
• For bulk operations (50+ objects), warn the user before proceeding
• Use mcp_generic as a last resort only — check specialized servers first
• Clean up temporary files (JSON, TSV, Python scripts) created for batch operations after the operation completes successfully
• mcp_command_line works without WAAPI — use it when Wwise is not running
• Profiler data requires enable_wwise_profiler_data to be called first for most data types
• If a tool from a wwise-* skill is missing, the active profile (listen, author, build, qa, admin) excludes its server. Tell the user which profile adds it (see the profile line in that skill)

WAAPI Gotchas

Root Path Queries Return Empty

Never use from_path: ["\\"] (the absolute root) in object queries — WAAPI returns 0 results. Always query from specific hierarchy roots: ["\\Containers"], ["\\Events"], ["\\Master-Mixer Hierarchy"], ["\\Actor-Mixer Hierarchy"], etc. If a query returns 0 results, try a different from_path before concluding the project is empty.

Output Bus Inheritance

When querying @OutputBus on a Wwise object, WAAPI returns the LOCAL value, not the effective (inherited) one. If @OverrideOutput is false, the object inherits its output bus from an ancestor. To find the actual routing, walk the ancestor chain (using select_transform="ancestors") and find the nearest ancestor where @OutputBus is set. Always check @OverrideOutput.

Audio Import Requires WAV

WAAPI's audio import (import_audio_files, import_tab_delimited_file) only creates AudioFileSource objects for WAV files. Other formats (OGG, FLAC, MP3) get copied to the Originals folder but are not linked to their Sound objects — the import silently succeeds with no AudioFileSource created. If source audio is not WAV, convert to WAV first (e.g. via ffmpeg) before importing.