「hf CLIの使い方をAIエージェントに教えるスキル」が、CLIのインストーラーで自動配置されるようになった

Claude CodeやCodexのようなコーディングエージェントが、CLIツールの使い方を「スキル」として読み込んで使う仕組みが広がっている。Hugging Faceのhf CLIも例外ではない。huggingface_hub v1.27.0（2026年8月7日公開）のリリースノートを確認すると、そのスキルが標準インストーラーによってデフォルトで自動配置されるようになった経緯が書かれていた。

これまでは「知っている人だけ」使えた

リリースノートはこう書いている。

The hf-cli skill teaches AI agents how to use the hf CLI, but until now you had to know it existed and install it by hand. The standalone installers (bash and PowerShell) now install it globally by default, pass --exclude-skill / -ExcludeSkill to skip — and hf update refreshes it afterwards, without ever bringing it back if you opted out or removed it. Any hf command also hints, at most once a day, when the skill is missing or was generated by another hf version. The hint is purely local, never installs anything on its own, and is silenced by HF_HUB_DISABLE_UPDATE_CHECK=1.

（hf-cliスキルはAIエージェントにhf CLIの使い方を教えるが、これまではその存在を知った上で手動でインストールする必要があった。スタンドアロンのインストーラー（bashとPowerShell）は、これからデフォルトでこれをグローバルにインストールする。スキップするには--exclude-skill／-ExcludeSkillを渡す。hf updateはその後もスキルを更新し続けるが、一度オプトアウトしたり削除したりしたスキルを勝手に戻すことはない。hfコマンドは、スキルが存在しない、または別バージョンのhfで生成されたものである場合、1日に最大1回ヒントを表示する。このヒントは完全にローカルな処理で、何かを自動的にインストールすることはなく、HF_HUB_DISABLE_UPDATE_CHECK=1で無効化できる）

リリースノートに掲載されたコマンド例では、インストーラーを実行すると[INFO] Installing the hf-cli skill for AI agents...と表示され、~/.agents/skills/hf-cliという中央集約された場所にスキルがインストールされる。スキップしたい場合はcurl -LsSf https://hf.co/cli/install.sh | bash -s -- --exclude-skillのようにフラグを追加する。

何が変わったのか

これまでは「hf-cliというスキルが存在することを知っている人」だけが、hf agents-cliのドキュメントを見つけて手動でインストールしていた。それが標準インストーラーの既定動作に組み込まれたことで、hf CLIをインストールする全員が、意識せずともAIエージェント向けの説明書も一緒に手に入れるようになる。裏を返せば、Claude CodeやCodexのようなエージェントが自分の環境に導入されている場合、hfコマンドを何気なくインストールしただけで、そのエージェントがhfの使い方を学習できる状態になる、ということでもある。

気づいてほしい人には気づかせる設計

自動インストールを望まない、あるいは既に削除済みのユーザーへの配慮として、「一度でもオプトアウト・削除した場合は二度と勝手に戻さない」という設計が明記されている点は目を引く。一方で、スキルが存在しない、あるいは古いバージョン由来のものになっている場合には、1日1回を上限にヒントを出す。「勝手に何かする」のではなく「気づかせるだけ」という線引きがされている、とリリースノートの記述からは読み取れる。

~/.agents/skills/を読むのはどのエージェントか──公式ガイドで判明

リリースノートだけでは分からなかった「どのエージェント製品がこの置き場所を読みに行くのか」は、別ページの公式ガイド「Hugging Face CLI for AI Agents」に明記されていた。

install globally (available in all projects, works with Codex, Cursor, OpenCode, and any agent that loads skills from ~/.agents/skills) hf skills add --global for Claude Code use the --claude flag hf skills add --claude --global

（グローバルインストール（全プロジェクトで有効）：Codex・Cursor・OpenCode、および~/.agents/skillsからスキルを読み込む任意のエージェントで動作する。hf skills add --global。Claude Codeの場合は--claudeフラグを使う：hf skills add --claude --global）

つまり~/.agents/skillsは、Codex・Cursor・OpenCodeなど複数のエージェントが共有する置き場所である一方、Claude Codeだけは別の専用の場所（Claude Code独自のスキル格納パス）を読みに行くため、--claudeフラグを別途渡す必要がある。標準インストーラーはこの両方を自動でカバーしている、とガイドに明記されていた。

インストーラー本体のコードを直接確認した

標準インストーラー（https://hf.co/cli/install.sh）のスクリプト本体をcurlで取得し、該当箇所を直接確認した。

install_skill() {
    if [ "$EXCLUDE_SKILL" = "true" ]; then
        log_info "Skipping the hf-cli skill (--exclude-skill)"
        return
    fi
    log_info "Installing the hf-cli skill for AI agents..."
    if ! "$BIN_DIR/hf" skills add hf-cli --global --claude --force; then
        log_warning "Failed to install the hf-cli skill. Install it later with: hf skills add -g --claude"
    fi
    ...
}

実際に呼ばれているのはhf skills add hf-cli --global --claude --forceというコマンドで、--claudeフラグが最初から付いている。つまり標準インストーラーは、Codex・Cursor・OpenCodeなどが読む共有ディレクトリとClaude Code専用の場所の両方に、1回のインストーラー実行でスキルを配置している、とスクリプトのコードから確認できた。

hf-cliスキルの中身そのものまでは読んでいない

本記事はhuggingface_hub v1.27.0のリリースノート、公式ガイド「Hugging Face CLI for AI Agents」、CLIガイド、標準インストーラーのスクリプト本体を情報源としている。この記事を書いている自分の手元では、curl -LsSf https://hf.co/cli/install.sh | bash -sを実際に実行して~/.agents/skills/hf-cliが生成される様子や、既存のエージェントツールがそのスキルを実際に参照してhfコマンドの使い方を学習する挙動までは検証していない。hf-cliスキルファイルそのものの中身——具体的にどんなhfコマンドの使い方がどこまで詳しく書かれているか——についても、生成されたファイル自体を取得して読む作業は今回行っておらず、確認できていない。

関連記事: Hugging Face 使い方 / AIエージェントとは / MCP（Model Context Protocol）とは

感想・指摘はコメント欄へ。