Skip to content

DevNullLtd/Yuzu / .codex/skills/yuzu-build

yuzu-build

Unverified

Configure, compile, and test Yuzu with the repo's canonical Meson entrypoints and per-OS build directories. Use when validating code changes, selecting test suites, reconfiguring a build directory, or recovering from host/builddir mismatches on Linux, macOS, or Windows.

Yuzu Build

Start Here

  • Use ./scripts/setup.sh unless the user explicitly wants raw meson setup.
  • Use canonical build directories: build-linux, build-windows, and build-macos.
  • Use --tests when the task needs meson test.
  • If scripts/setup.sh reports that a build directory came from another host, re-run with --wipe or a different build directory instead of forcing reuse.

Choose The Path

  • On Linux, run ./scripts/setup.sh [--tests] and then meson compile -C build-linux.
  • On macOS, run ./scripts/setup.sh [--tests] and then meson compile -C build-macos.
  • On Windows, invoke $yuzu-windows-msvc first and then use build-windows.
  • Meson resolves the gateway's Erlang/OTP (28.4 or later 28.x) at configure, for the gateway custom target and its tests; source scripts/ensure-erlang.sh only before running rebar3 or erl by hand.

Choose Tests

  • Read tests/meson.build to map the change to a suite.
  • Prefer targeted suites first: agent, server, echo, proto, and docs.
  • Run meson test -C <builddir> --suite <suite> --print-errorlogs.
  • Expand to broader coverage only when the change crosses multiple areas or the targeted suite fails unexpectedly.

Invoke Sibling Skills

  • Invoke $yuzu-meson for any meson.build, dependency, or source-list change.
  • Invoke $yuzu-proto for any .proto, codegen, or gateway proto mirror change.
  • Invoke $yuzu-plugin-abi for SDK or plugin boundary changes.
  • Invoke $yuzu-windows-msvc for any Windows, MSVC, or vcpkg issue.

Read On Demand

  • scripts/setup.sh
  • tests/meson.build
  • scripts/run-tests.sh
  • docs/windows-build.md
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall