gohud

Go HUD Skill

gohud には AI スキルが入っている — API のすべて、すぐ動くテンプレート、プレビュー起動器。下の文をまるごとコーディングエージェントに貼れば、gohud を入れて使い方まで覚える。

これをコーディングエージェントに貼り付ける

エージェントで Godot プロジェクトを開き、下の文を貼って送る。スキルとアドオンを入れ、gohud で何ができるかまで教えてくれる。

  1. Godot プロジェクトのフォルダーでターミナルを開き、そこでコーディングエージェントを起動する — 例: claude。
  2. 下のブロックのコピーを押し、エージェントに貼って送る。
  3. 終わったら、求められればエージェントを再起動し、こう聞く: gohud で何ができる?
Install gohud for this Godot 4.7+ project, then use it for all game UI
(menus, HUD bars, quick slots, dialogs, bottom sheets, forms, themes).

1. Install the gohud AI skill.
   Claude Code - run these two commands in a shell:
     claude plugin marketplace add thruthesky/gohud
     claude plugin install gohud@gohud
   Any other agent (Codex, Cursor, Gemini CLI, ...):
     git clone --depth 1 https://github.com/thruthesky/gohud.git /tmp/gohud
     Copy /tmp/gohud/skills/gohud into whichever of these folders this agent reads:
     ~/.claude/skills/gohud, .claude/skills/gohud, .agents/skills/gohud.

2. Install the add-on itself, unless addons/gohud/plugin.cfg already exists here.
   In a git repository:
     git submodule add https://github.com/thruthesky/gohud.git addons/gohud
   Otherwise copy the clone to addons/gohud without its .git folder.
   Then run: godot --headless --path . --import
   (If godot is not on PATH, ask me where Godot 4.7+ is.)

3. Check the result: addons/gohud/plugin.cfg exists and the import printed
   no "SCRIPT ERROR" or "Parse Error" lines.

4. A new skill loads when the agent starts. Tell me if I have to restart you,
   then tell me what gohud can do and how to preview it.

Docs: https://thruthesky.github.io/gohud/
この文はわざと英語にしてある — どのエージェントもいちばん正確に読む言葉だからだ。質問は何語でもいい。スキルはあなたが書いた言葉で答える。

またはコマンド 2 行 — Claude Code

スキルを Claude Code のプラグインとして入れる。ターミナルで:

claude plugin marketplace add thruthesky/gohud
claude plugin install gohud@gohud

すでに Claude Code の中なら、こちらを打つ:

/plugin marketplace add thruthesky/gohud
/plugin install gohud@gohud

それから Claude Code を再起動して /gohud:features と打つ — gohud の機能一覧が出ればスキルは入っている。アドオン本体は別に addons/gohud に要る: インストール →

エージェントごとのスキル置き場

手で入れるなら skills/gohud フォルダーをエージェントが読む場所に置く。先にあるものが使われる。

エージェントフォルダーを置く場所コマンドの形
Claude Code — プラグインclaude plugin install gohud@gohud/gohud:preview · /gohud:features
Claude Code — スキルのみ~/.claude/skills/gohud/gohud preview · /gohud features
Claude Code — このプロジェクトだけ.claude/skills/gohud/gohud preview
Codex · Cursor · Gemini CLI — その他.agents/skills/gohud—

使えるようになるコマンド

ギャラリーを開く。すべてのウィジェット、すべてのプリセットの選択リスト、アイコン一式が入っている。自分の Godot プロジェクトの中で打てばそのプロジェクトの addons/gohud を使い、無ければプラグイン同梱の コピーか、新しくクローンしたものを使う。使い捨てのサンドボックスプロジェクトで動くので、自分のオートロードや インポートキャッシュには触れず、ウィンドウは閉じるまで開いたままだ。

/gohud:preview demo — 15章のガイドツアー

デモを開始画面で開く。Start demo は実際の入力でツアーを再生し、Explore widgets は ウィジェット1つを手で試させる。サンプルに挙げたキー操作はここでも同じだ。

ほかにも多くのコマンドがある

コマンド役割
/gohud:preview medieval中世プリセットのキャラクターシート・雑嚢・クエストジャーナル
/gohud:preview demo --explore hudデモを1章だけ直接開く — hud buttons inputs selection lists data states surfaces prompt touch coach scrolling forms anchors theming
/gohud:preview gallery --preset scifi_darkプリセット1つを当てたギャラリー。--phone で 390×844 のスマートフォン窓、--size 1920x1080 で任意のサイズ
/gohud:preview res://ui/main_menu.tscn自分のプロジェクトのシーンを、そのプロジェクトの中で実行する
/gohud:preview list開ける対象・プリセット id・デモの章キーの一覧
/gohud:preview gallery --checkウィンドウを出さないヘッドレス点検 — スクリプトエラーがあれば失敗する
/gohud:features機能を分類ごとに、1機能あたりコード1行で
/gohud:features hud1つの分野を深く — surfaces hud style theming icons i18n accessibility config

プレビューのコマンドには PATH に Godot 4.7 以上が要る。

ふつうに頼んでもいい

そのまま頼んでもよい。 スキルがエージェントに gohud の API 全体を教えるので、 「gohud でポーズメニューを作って」のような普通の依頼も通る。プラグインではなく素のスキルとして ~/.claude/skills/gohud に置いた場合はコマンドを空白で区切る — /gohud preview demo、 /gohud features。プレビューには PATH の通った Godot 4.7 以降が必要で、 無ければ --godot /path/to/godot で渡す。