S2r Skills

Source 2 Skills

A collection of agent skills for working with Source 2 resources and developing related code. It covers resource formats, engine APIs, tooling and practical workflows for maps and plugins.

Custom Hud Layout

[Skill](custom-hud-layout/SKILL.md) covers the `custom_hud_layout` entity (`CCSCustomHudLayout`): how to create a HUD, update it for all players or one player, and handle button clicks on the server.

Use it when building timers, scoreboards, progress indicators, shops, voting dialogs or menus. It includes a capture-point indicator example, API references and common validation errors.

How it works

XML defines the panels. A Panorama stylesheet defines their appearance. Server code updates text through dialog variables and changes visual states by toggling classes.

The layout accepts four panel types: `Panel`, `Label`, `Image` and `Button`. Each has a fixed set of attributes. Inline styles, client scripts and XML event handlers are not supported.

A HUD starts as an overlay. Enabling input capture for a player gives them a cursor and allows interaction. Button clicks arrive on the server through `OnCustomHudClicked`, with the player, layout and button ID

Installation

Install the skill globally for your agent. This requires Node.js and npm.

Restart the current agent session after installation. The skill is available in every project and can be selected automatically when the task matches its description.

To install it only for the current project, run the command from the project root without `--global`.

Claude Code (CLI and VS Code)

npx skills add Wend4r/s2l-skills --skill custom-hud-layout --global --agent claude-code

Codex

npx skills add Wend4r/s2l-skills --skill custom-hud-layout --global --agent codex

Cursor

npx skills add Wend4r/s2l-skills --skill custom-hud-layout --global --agent cursor

GitHub Copilot

npx skills add Wend4r/s2l-skills --skill custom-hud-lay