yuzu-build

Automate Yuzu setup, build, and testing across Linux, macOS, and Windows.

15|7|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/Tr3kkR/Yuzu --skill yuzu-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yuzu-build
Source: https://github.com/Tr3kkR/Yuzu/tree/main/.codex/skills/yuzu-build
Command: npx skills add https://github.com/Tr3kkR/Yuzu --skill yuzu-build

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configuring, building, and testing Yuzu across Linux, macOS, and Windows can be error-prone and time-consuming without a canonical workflow. This Skill guides users to run the canonical Meson-based entrypoints and per-OS build directories to ensure consistent results.

Core Features & Use Cases

  • Canonical build directories: build-linux, build-macos, build-windows for predictable outputs.
  • Guided setup and test selection: use scripts/setup.sh and provide --tests to run appropriate test suites.
  • OS-aware build and test commands: per-OS instructions and fallbacks to recover from host/builddir mismatches.

Quick Start

Run ./scripts/setup.sh to configure, then compile with meson -C build-linux on Linux, meson -C build-macos on macOS, or meson -C build-windows on Windows.

Frequently Asked Questions about yuzu-build

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build Yuzu across Linux, macOS, and Windows consistently?

To build Yuzu consistently across Linux, macOS, and Windows, run the provided setup script and use canonical Meson build directories like build-linux, build-macos, or build-windows to manage OS-specific compilations.

What is the best way to automate Yuzu setup and testing on multiple operating systems?

Automating Yuzu setup and testing involves running scripts/setup.sh for configuration and passing the --tests flag to execute appropriate test suites, ensuring consistent validation across different operating systems.

How do I fix host and builddir mismatches when compiling Yuzu with Meson?

Fixing host and builddir mismatches when compiling Yuzu involves using OS-specific fallback commands to reconfigure the correct canonical build directory, such as build-linux or build-windows, via Meson.

Can I use Meson to reconfigure a Yuzu build directory after code changes?

Yes, you can use Meson to reconfigure a Yuzu build directory after code changes by running meson -C build-linux, build-macos, or build-windows, which applies the necessary updates to the existing build environment.

Why does my Yuzu build fail when using a non-canonical build directory?

A Yuzu build may fail when using a non-canonical build directory because the workflow strictly enforces predictable paths like build-linux, build-macos, and build-windows to prevent configuration and output errors.

Do I need to run setup.sh every time I compile Yuzu on macOS or Linux?

You do not need to run setup.sh every time you compile Yuzu on macOS or Linux; run it once for initial configuration, then use meson -C build-linux or build-macos for subsequent compilations and updates.