hf-cli

hf-cli skill の概要

hf-cli skill は、Hugging Face Hub CLI の hf を使って、認証、ファイルのダウンロードとアップロード、repo と bucket の管理、model や dataset の確認、そして Hugging Face サービスの操作をターミナルから行うための skill です。単発のWebクリックではなく、再現性がありスクリプト化しやすい Hub アクセスが必要な Backend Development のワークフローに特に適しています。

hf-cli は何のための skill か

hf-cli skill を使うのは、login 状態、cache の扱い、repo の同期、dataset の問い合わせ、endpoint のセットアップ、webhook、job、あるいはローカル環境と Hub の間で artifact を移動するといった運用タスクです。すでに Hugging Face エコシステムには慣れているが、正確な command の流れ、flag、インストール手順が必要な場合に特に役立ちます。

この skill が適しているケース

Hub の操作を自動化したい、CI/CD に組み込みたい、あるいは CLI を中心にチームのワークフローを標準化したいなら、hf-cli を選んでください。依頼が、信頼できる command syntax、最新の auth 動作、どの hf subcommand が作業に合うかの判断を必要とする場合、一般的な prompt よりも適しています。

何が違うのか

主な価値は、概念説明ではなく実用的な command 選定にあります。この hf-cli ガイドは最新の hf command を中心に、非推奨の huggingface-cli を置き換えるものであることを示し、auth、cache、Hub resource 管理まわりの手探りを避けられるようにします。

hf-cli skill の使い方

CLI をインストールして確認する

skill は npx skills add huggingface/skills --skill hf-cli でインストールします。その後、hf --help と hf auth whoami を確認して、CLI が利用可能で最新かを確かめてください。古いドキュメントから移行する場合は、huggingface-cli を legacy とみなし、新しい command では hf を使うのが基本です。

目的を実用的な prompt に落とし込む

良い hf-cli usage は、漠然とした「Hugging Face のことを手伝って」ではなく、具体的なゴールから始まります。何を移動・管理したいのか、それがどこにあるのか、制約は何かを含めてください。たとえば「fine-tuned model フォルダを org/model-name に upload し、config.json と model.safetensors だけ残し、CI の token で認証する」といった形です。これなら、skill が適切な subcommand と flag を選ぶのに十分な文脈が得られます。

先に読むべきファイル

まず SKILL.md を読み、次に README.md、AGENTS.md、metadata.json、そして存在するなら rules/、resources/、references/、scripts/ フォルダを確認してください。この repo では SKILL.md が主な情報源なので、大きな file tree を追いかけるよりも、command モデル、対応タスク、移行時の注意点を抽出するのが中心になります。

実際のワークフロー制約を付けて使う

同僚に伝えるのと同じ粒度で、repo ID、file path、revision や branch、cache の場所、command を local で実行するのか CI で実行するのか、dry run が必要か、最小限の出力でよいかを伝えてください。こうした情報は hf-cli install と hf-cli usage の案内を大きく改善します。対象 resource を絞り込み、誤った upload、download、auth ミスを減らせるからです。

hf-cli skill FAQ

hf-cli は model のダウンロード専用ですか？

いいえ。hf-cli skill は download と upload だけでなく、authentication、cache 管理、repo、dataset、space、bucket、job、paper など、関連する Hub 操作全般をカバーします。Hugging Face エコシステムに触れる作業なら、hf-cli は多くの場合よい出発点です。

shell command をすでに知っていても必要ですか？

はい。command エラーを減らし、セットアップを速くしたいなら有用です。通常の prompt でも考え方は説明できますが、最新の CLI syntax、正しい hf subcommand、あるいは非推奨の huggingface-cli からの移行手順が必要なときは、hf-cli のほうが向いています。

hf-cli は初心者にも向いていますか？

はい。ただし、依頼は具体的であることが前提です。初心者は、やりたい作業と対象 repo を明示すると最も良い結果が得られます。たとえば「ログインして、local test 用に dataset の snapshot を1つダウンロードしたい」といった依頼です。これは、「Hugging Face CLI を見せて」のような広い依頼よりも、実行可能な command に落とし込みやすくなります。

いつ hf-cli を使わないべきですか？

純粋に概念的な相談、Hub と無関係な作業、あるいは自動化不要で web UI だけで十分なケースでは使わないでください。また、CLI 操作ではなく一般的な AI/ML の助言だけが欲しい場合も、最適ではありません。

hf-cli skill をより良く使う方法

最も厳しい制約を最初に伝える

強い hf-cli の入力には、「何をしてはいけないか」が含まれます。たとえば、full cache download は不可、上書き不可、public exposure 不可、interactive login 不可、余分な file は不可、といった条件です。こうした制約は command の選択を変えるため、上位の目的より重要になることがよくあります。

正確な Hub object を明記する

repo の種類と識別子をはっきり書いてください。model、dataset、space、bucket、endpoint、job のどれかを指定します。hf-cli の出力は、対象が org/repo なのか、特定の revision なのか、あるいは Hub に同期すべき local directory なのかが分かるほど良くなります。

command だけでなく workflow も頼む

使える hf-cli guide がほしいなら、command に加えて最短で安全な workflow も求めてください。つまり、install、auth、verify、execute、validate までです。そうすると、hf auth whoami、cache の確認、revision の選択といった、試行錯誤を減らす実用的な手順が見えやすくなります。

実際の出力とエラーで反復する

最初の command が失敗したら、表示された error、実行した command、対象にした resource をそのまま貼ってください。これが hf-cli for Backend Development の改善として最も速い方法です。次の回答では、flag、auth 状態、path の前提、Hub 権限を推測ではなく修正できます。