Run any Skill in Manus with one click

adv-format

Stars0

Forks0

UpdatedJuly 6, 2026 at 22:52

Apply or check the Adventure C++ house style with clang-format. Use before committing C++ changes, or when CI's format gate fails. Formats src/tests/bench per .clang-format (tabs, Allman, ColumnLimit 0); never touches vendored deps/.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Xian55

Xian55/Adventure

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	adv-format
description	Apply or check the Adventure C++ house style with clang-format. Use before committing C++ changes, or when CI's format gate fails. Formats src/tests/bench per .clang-format (tabs, Allman, ColumnLimit 0); never touches vendored deps/.

adv-format — apply / check house style

Style is enforced by .clang-format (root) and gated in CI. clang-format 19.x (VS ships one at C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\Llvm\bin\clang-format.exe; or pip install clang-format==19.1.5). deps/ is excluded via deps/.clang-format (DisableFormat).

Apply (before committing)

CF="/c/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/Llvm/bin/clang-format.exe"
files=$(git ls-files 'src/*.cpp' 'src/*.h' 'tests/*.cpp' 'bench/*.cpp' 'bench/*.h')
"$CF" -i $files

Check (what CI runs — fails if anything isn't clean)

"$CF" --dry-run --Werror $(git ls-files 'src/*.cpp' 'src/*.h' 'tests/*.cpp' 'bench/*.cpp' 'bench/*.h')

Style summary (see docs/design/CONVENTIONS.md for the full rule set)

Tabs (width 4), Allman braces — but lambda bodies stay inline.
ColumnLimit: 0 — never auto-wrap; break long lines by hand.
m_ members, PascalCase types, k-constants, left pointers/refs (int* p, int& r).
One record per line for multi-element vector/array/string-literal lists (trailing comma). clang-format preserves this layout but won't auto-explode a packed list — write it exploded.
Lean comments: one line, the why. No walls — long explanation goes in the subsystem CLAUDE.md.

More from this repository

same repository

adv-input-action

Xian55/Adventure

Add or change a player input action (a key/mouse-driven control) the right way — routed through the rebindable input action map, never a hard-coded key. Use whenever you introduce a new control (a new key/button the player presses) or change how an existing control is read, so it stays rebindable via keybindings.cfg.

2026-07-110

adv-test

Xian55/Adventure

Build and run the Adventure headless unit-test suite (doctest via CTest). Use after changing anything in adventure_lib (Lua engine, metrics, systems) to check for regressions before committing.

2026-07-060

adv-map

Xian55/Adventure

Authoritative reference for the TrenchBroom/Quake Valve 220 .map format and Adventure's map conventions. Use when authoring, generating, editing, debugging, or validating a .map file, or wiring TrenchBroom to the project. TrenchBroom has no MCP server or CLI/scripting API — .map is plain text, so we generate/validate it ourselves (parser: src/world/MapParser).

2026-07-060

adv-onboard

Xian55/Adventure

Bootstrap a new contributor (or a fresh machine) into the Adventure project — install the toolchain, set environment variables, build, and verify everything works. Use when someone is setting up the project for the first time, or when a clean-machine setup / environment problem needs fixing.

2026-07-060

adv-sprite

Xian55/Adventure

Produce/export game sprites (billboard atlases, viewmodels) with Aseprite via the ASEPRITE env var, so scripts stay machine-independent. Use when creating or batch-exporting sprite sheets, or setting up Aseprite CLI automation for the asset pipeline.

2026-07-060

adv-docs

Xian55/Adventure

Keep the project's documentation current after a code change — the subsystem CLAUDE.md files, the root CLAUDE.md, and docs/design. Use at the end of any feature or structural change (it's the final step of adv-feature), or whenever architecture, commands, conventions, or milestone status shift.

2026-07-060

name	adv-format
description	Apply or check the Adventure C++ house style with clang-format. Use before committing C++ changes, or when CI's format gate fails. Formats src/tests/bench per .clang-format (tabs, Allman, ColumnLimit 0); never touches vendored deps/.

adv-format — apply / check house style

Apply (before committing)

CF="/c/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/Llvm/bin/clang-format.exe"
files=$(git ls-files 'src/*.cpp' 'src/*.h' 'tests/*.cpp' 'bench/*.cpp' 'bench/*.h')
"$CF" -i $files

Check (what CI runs — fails if anything isn't clean)

"$CF" --dry-run --Werror $(git ls-files 'src/*.cpp' 'src/*.h' 'tests/*.cpp' 'bench/*.cpp' 'bench/*.h')

Style summary (see docs/design/CONVENTIONS.md for the full rule set)

Tabs (width 4), Allman braces — but lambda bodies stay inline.
ColumnLimit: 0 — never auto-wrap; break long lines by hand.
m_ members, PascalCase types, k-constants, left pointers/refs (int* p, int& r).
One record per line for multi-element vector/array/string-literal lists (trailing comma). clang-format preserves this layout but won't auto-explode a packed list — write it exploded.
Lean comments: one line, the why. No walls — long explanation goes in the subsystem CLAUDE.md.