Agent skill

Hud

by yangyuan-zhen in yangyuan-zhen/PolyWeather

[OMX] Show or configure the OMX HUD (two-layer statusline). An agent skill from yangyuan-zhen/PolyWeather.

AGPL-3.0Auto-check passed

Install Hud

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/hud .claude/skills/hud && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .claude/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.codex/skills/hud .agents/skills/hud && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .agents/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.codex/skills/hud .cursor/skills/hud && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .cursor/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/yangyuan-zhen/PolyWeather.git --path .codex/skills/hud

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.codex/skills/hud .gemini/skills/hud && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .gemini/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .github/skills && cp -r skills-src/.codex/skills/hud .github/skills/hud && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .github/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yangyuan-zhen/PolyWeather --skill hud -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install yangyuan-zhen/PolyWeather hud --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yangyuan-zhen/PolyWeather.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.codex/skills/hud .opencode/skills/hud && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "hud" agent skill from https://github.com/yangyuan-zhen/PolyWeather/tree/main/.codex/skills/hud into .opencode/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: hud
GitHub stars: 316
Token cost: ~765 tokens
SKILL.md length: 281 words
Files: 1
Skills in repo: 26
Repo updated: Sep 20, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

[OMX] Show or configure the OMX HUD (two-layer statusline). An agent skill from yangyuan-zhen/PolyWeather.

Works in 2 steps: Layer 1 - Codex built-in statusLine:… → Layer 2 - omx hud CLI command: Shows…
SKILL.md covers Quick Commands, Presets, Setup and Layer 1: Codex Built-in…, plus 4 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hud is an agent skill from yangyuan-zhen/PolyWeather. [OMX] Show or configure the OMX HUD (two-layer statusline)

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: polymarket Intelligent Weather Quant Analysis Bot. The licence is AGPL-3.0.

Example prompts

“/hud”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

Layer 1 - Codex built-in statusLine: Real-time TUI footer showing model, git branch, and context usage. Configured via [tui] status_line…
Layer 2 - omx hud CLI command: Shows OMX-specific orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns). Reads…

What it can do on your machine

Read from SKILL.md and the folder at commit 43e658b. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are toml and json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hud loads about 765 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 281 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~16
When it runs · the whole SKILL.md, loaded when a task matches: ~765

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yangyuan-zhen/PolyWeather at commit 43e658b, republished under its AGPL-3.0 licence (© yangyuan-zhen). 281 words, ~765 tokens.

Download SKILL.mdSave it as .claude/skills/hud/SKILL.md (or your agent's skills folder).

name: hud
description: [OMX] Show or configure the OMX HUD (two-layer statusline)
role: display
scope: .omx/**

HUD Skill

The OMX HUD uses a two-layer architecture:

Layer 1 - Codex built-in statusLine: Real-time TUI footer showing model, git branch, and context usage. Configured via [tui] status_line in ~/.codex/config.toml. Zero code required.
Layer 2 - omx hud CLI command: Shows OMX-specific orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns). Reads .omx/state/ files.

Quick Commands

Command	Description
`omx hud`	Show current HUD (modes, turns, activity)
`omx hud --watch`	Live-updating display (polls every 1s)
`omx hud --json`	Raw state output for scripting
`omx hud --preset=minimal`	Minimal display
`omx hud --preset=focused`	Default display
`omx hud --preset=full`	All elements

Presets

minimal

[OMX] ralph:3/10 | turns:42

focused (default)

[OMX] ralph:3/10 | ultrawork | team:3 workers | turns:42 | last:5s ago

full

[OMX] ralph:3/10 | ultrawork | autopilot:execution | team:3 workers | pipeline:exec | turns:42 | last:5s ago | total-turns:156

Setup

omx setup automatically configures both layers:

Adds [tui] status_line to ~/.codex/config.toml (Layer 1)
Writes .omx/hud-config.json with default preset (Layer 2)
Default preset is focused; if HUD/statusline changes do not appear, restart Codex CLI once.

Layer 1: Codex Built-in StatusLine

Configured in ~/.codex/config.toml:

toml

[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]

Available built-in items (Codex CLI v0.101.0+): model-name, model-with-reasoning, current-dir, project-root, git-branch, context-remaining, context-used, five-hour-limit, weekly-limit, codex-version, context-window-size, used-tokens, total-input-tokens, total-output-tokens, session-id

Layer 2: OMX Orchestration HUD

The omx hud command reads these state files:

.omx/state/ralph-state.json - Ralph loop iteration
.omx/state/ultrawork-state.json - Ultrawork mode
.omx/state/autopilot-state.json - Autopilot phase
.omx/state/team-state.json - Team workers
.omx/state/pipeline-state.json - Pipeline stage
.omx/state/ecomode-state.json - Ecomode active
.omx/state/hud-state.json - Last activity (from notify hook)
.omx/metrics.json - Turn counts

Configuration

HUD config stored at .omx/hud-config.json:

json

{
  "preset": "focused"
}

Color Coding

Green: Normal/healthy
Yellow: Warning (ralph >70% of max)
Red: Critical (ralph >90% of max)

Troubleshooting

If the TUI statusline is not showing:

Ensure Codex CLI v0.101.0+ is installed
Run omx setup to configure [tui] section
Restart Codex CLI

If omx hud shows "No active modes":

This is expected when no workflows are running
Start a workflow (ralph, autopilot, etc.) and check again

Files

Just SKILL.md in .codex/skills/hud of yangyuan-zhen/PolyWeather.

Open the folder on GitHubat commit 43e658b

Compare with similar skills

Hud next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hud compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Hud this skillyangyuan-zhen/PolyWeather	316	—	~765	Automated safety check: Pass	AGPL-3.0	20 days ago
OMC HUD Statusline SetupYeachan-Heo/oh-my-claudecode	40k	—	~2.5k	Automated safety check: Pass	MIT	2 days ago
Configure Channelopenclaw/openclaw	392k	—	~946	Automated safety check: Pass	MIT	today
Hudbrycewang-stanford/Auto-Empirical-Research-Skills	4.6k	—	~1.4k	Automated safety check: Pass	Custom licence	5 days ago
ConfigurationBuilderIO/agent-native	7.1k	—	~2.1k	Automated safety check: Pass	None	yesterday
Configure Eccaffaan-m/ECC	277k	1 repos	~2k	Automated safety check: Pass	MIT	today

Similar skills

OMC HUD Statusline Setup
Yeachan-Heo/oh-my-claudecode
Installs and configures the oh-my-claudecode heads-up display in the Claude Code statusline, with minimal, focused and full layouts.
40k GitHub stars~2.5k tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
Configure Channel
openclaw/openclaw
Configure and prove a chat channel with non-interactive one-liners; secrets only as SecretRefs.
392k GitHub stars~946 tokensUpdated today
Auto-check passed
Hud
brycewang-stanford/Auto-Empirical-Research-Skills
Diverga HUD (Heads-Up Display) management skill. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.
4.6k GitHub stars~1.4k tokensUpdated 5 days ago
Auto-check passed
Configuration
BuilderIO/agent-native
Where a configuration value belongs — app config schema, agent-native.config.ts, or an environment variable — and how the layers resolve.
7.1k GitHub stars~2.1k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Configure Ecc
affaan-m/ECC
Run the conversational ECC setup wizard inside the current harness: inventory the install, collect scope (user/project/local) and hook mode (off/minimal/standard/strict) in Claude Code, use Codex's…
277k GitHub starsUsed in 1 repo~2k tokens
Auto-check passed
Configure Ecc
affaan-m/ECC
Claude Code、Codex、Kimi 内で ECC のインストール、更新、再設定を案内し、各ハーネスが実際に備えるプラグイン、スコープ、フック機能を守ります。
276k GitHub stars~1.3k tokensUpdated yesterday
Auto-check passed

Questions about Hud

What does Hud do?

[OMX] Show or configure the OMX HUD (two-layer statusline). An agent skill from yangyuan-zhen/PolyWeather. Hud is an agent skill from yangyuan-zhen/PolyWeather.

How do I install Hud in Claude Code?

Run `npx skills add yangyuan-zhen/PolyWeather --skill hud -a claude-code`. Or copy the skill folder (.codex/skills/hud in yangyuan-zhen/PolyWeather) into .claude/skills/hud in your project. Claude Code loads it when a task matches its description.

How do I install Hud in Codex?

Run `npx skills add yangyuan-zhen/PolyWeather --skill hud -a codex`. Or copy the skill folder (.codex/skills/hud in yangyuan-zhen/PolyWeather) into .agents/skills/hud in your project. Codex loads it when a task matches its description.

Can I use Hud in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yangyuan-zhen/PolyWeather --skill hud -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hud, .gemini/skills/hud, .github/skills/hud and .opencode/skills/hud in your project.

What does Hud need to run?

SKILL.md names no scripts, command-line tools or credentials: Hud is instructions for the agent only.

Does Hud access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hud safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hud use?

Hud is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hud use?

About 765 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hud?

Skills that share tags, products or a category with Hud: OMC HUD Statusline Setup (Yeachan-Heo/oh-my-claudecode, 40k stars), Configure Channel (openclaw/openclaw, 392k stars), Hud (brycewang-stanford/Auto-Empirical-Research-Skills, 4.6k stars) and Configuration (BuilderIO/agent-native, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hud?

yangyuan-zhen (a GitHub user) maintains it in yangyuan-zhen/PolyWeather, which has 316 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on September 20, 2026.

Source: yangyuan-zhen/PolyWeather on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Hud

Facts

At a glance

What it does

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

HUD Skill

Quick Commands

Presets

minimal

focused (default)

full

Setup

Layer 1: Codex Built-in StatusLine

Layer 2: OMX Orchestration HUD

Configuration

Color Coding

Troubleshooting

Files

Compare with similar skills

Similar skills

More from yangyuan-zhen/PolyWeather

Questions about Hud