DevNullLtd/Yuzu / .codex/skills/yuzu-build
yuzu-build
VerifiedConfigure, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.9 KB |
| agents/openai.yaml | config | 190 B |
SKILL.md
View on GitHub---
name: yuzu-build
description: 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`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |