Claude Codeの公式Unityプラグインで実際に入るもの（31スキル中27個）

Claude Code に公式の Unity プラグインを入れました。入れたあとで、何が増えたのかをフォルダで数えてみたら、説明と違いました。

入るのは「スキル」だけ

インストール先のフォルダを開くと、中身はこれだけです。

.agents/
.claude-plugin/     ← plugin.json（名前・版・説明だけ）
.codex-plugin/
assets/
skills/             ← SKILL.md が31個
LICENSE.md
README.md

.mcp.json はありません。commands/ も hooks/ も agents/ もありません。plugin.json の中にも mcpServers の記述はなく、名前・バージョン・説明・キーワードだけです。

公式ブログには、このプラグインは "installs Unity's engineering skills, the Unity CLI, and Unity's MCP server"（Unity 公式ブログ・2026-09-09）と書かれています。ただ、プラグイン自体が持っているのはスキルだけでした。

31個のうち27個しか読み込まれない

もっと実害があるのはこちらです。使えるスキルの一覧を見たとき、数が合いませんでした。

配布されているのは31個。読み込まれているのは27個。4個が、エラーも警告も出さずに消えています。

原因は frontmatter の YAML でした。

---
name: physics-3d-collision
description: 3D PhysX collision diagnostics.
Primary scope: OnCollisionEnter not firing, …
---

---
name: physics-3d-collision
description: "3D PhysX collision diagnostics.
Primary scope: OnCollisionEnter not firing, …"
---

引用符で囲んでいない値の中に コロン＋空白（: ） が入ると、YAML はそこを新しいキーの区切りだと解釈します。結果として frontmatter 全体の読み込みに失敗し、そのスキルは無かったことになります。

落ちていたのは次の4つでした。説明文の中に Primary scope: や TilingRules: のような書き方が含まれています。

いちばん困るのは ui です。UI の依頼を振り分ける入り口なので、これが無いと「メニューを作って」と頼んだときに、UI Toolkit と uGUI のどちらで書くかを自分で指定することになります。

自分で確かめる（数十秒）

「一覧に出ていないだけ」なのか「そもそも読めていない」のかは、インストール先のフォルダを直接読めば分かります。frontmatter を YAML として読み込んでみるだけです。

cd "$USERPROFILE/.claude/plugins/cache/claude-plugins-official/unity/<版>/skills"
python -c "
import pathlib, yaml
ok, bad = [], []
for d in sorted(pathlib.Path('.').iterdir()):
    f = d / 'SKILL.md'
    if not f.exists(): continue
    head = f.read_text(encoding='utf-8').split('---')[1]
    try:
        yaml.safe_load(head); ok.append(d.name)
    except Exception as e:
        bad.append((d.name, str(e).splitlines()[0]))
print('読める:', len(ok), '/ 壊れている:', len(bad))
for n, e in bad: print(' -', n, '->', e)
"

読める: 27 / 壊れている: 4
- physics-3d-collision -> mapping values are not allowed here
- tilemap-ruletile-createfromsegment -> mapping values are not allowed here
- ui -> mapping values are not allowed here
- ui-imgui -> mapping values are not allowed here

同じ確かめ方は、自分で書いたスキルにも使えます。 スキルは読み込みに失敗しても何も言わないので、気づく仕組みを自分で持っておくと安全です。

直るのを待たない

この不具合は 2026-09-10 に GitHub で報告されています（Issue #44）。2026-09-18 時点で open・コメント0件で、リポジトリの最新にも修正は入っていません。

当面の付き合い方は2つです。

1. 1

   落ちているスキルの担当を、自分で名指しする

   UI なら ui-uitk（UI Toolkit）か ui-ugui（uGUI）を指示に書く。3D の当たり判定やタイルの自動連結も同様
2. 2

   数を突き合わせる習慣をつける

   版が上がったら、配布数と読み込まれた数をもう一度数える。直ったかどうかが一発で分かる

まとめ

• 公式プラグインで入るのはスキルだけ。MCP の設定も commands も hooks も含まれない。CLI と MCP は、スキルの手順に沿って別途入れる
• 配布31個に対して、読み込まれたのは27個（plugin 0.1.2-beta・2026-09-18）
• 原因は frontmatter の description: が引用符で囲まれておらず、中に : が入っていること
• スキルは読み込みに失敗しても黙っている。 数を突き合わせるか、YAML として読ませて確かめる
• Issue #44 は未修正。落ちている4個の担当は、当面は自分で名指しする