Instalátor Hugging Face CLI nově zakládá agentům skill v domovské složce

Knihovna huggingface_hub 1.27.0 vyšla 7. srpna 2026 a mění to, co udělá jednořádková instalace příkazové řádky hf. Kromě samotného nástroje teď instalátor založí i skill: adresář se souborem SKILL.md, ze kterého si programy řízené jazykovým modelem načtou, co hf umí a kdy ho mají použít.

Kam soubor přistane a kdo ho čte

Skript stahovaný z hf.co/cli/install.sh po dokončení instalace zavolá hf skills add hf-cli --global --claude --force. Výsledkem je adresář ~/.agents/skills/hf-cli a symbolický odkaz na něj v ~/.claude/skills/hf-cli. Obojí je uživatelská, ne projektová složka, takže se skill načte v každém adresáři, kde agent poběží.

Rozdělení těch dvou cest popisuje komentář v constants.py: .agents/skills čte podle něj většina agentů, .claude/skills Claude Code. Dokumentace Hubu jmenovitě uvádí Codex, Cursor a OpenCode. Sdílený adresář skillů není vynález Hugging Face: popisuje ho specifikace Agent Plugins 1.0, ze které jsou přenosné právě skilly a servery MCP.

Přepínač --force na konci toho příkazu znamená, že instalace proběhne, i když adresář téhož jména už existuje. Nový obsah se připraví ve vedlejší dočasné složce a teprve pak se prohodí, takže při chybě uprostřed zůstane ten původní na místě. Kdo si ale znění skillu upravil ručně, o úpravu přijde.

Vypnout to jde a volba drží

Instalátor má pro odmítnutí přepínač --exclude-skill, na Windows -ExcludeSkill. Pak vypíše, že skill přeskočil, a nesahá nikam.

Zajímavější je, co se stane při aktualizaci. Příkaz hf update u samostatné instalace spouští instalátor znovu, takže by odmítnutí mohl tiše zrušit. Podle návrhu změny č. 4608, sloučeného 5. srpna a čítajícího dvanáct souborů, se proto nejdřív zjistí, jestli skill v některém z globálních adresářů je. Když není, dostane instalátor --exclude-skill; když je, spustí se v podprocesu hf skills update. Podproces je nutný proto, že se soubory CLI na disku právě vyměnily, kdežto běžící proces má v paměti starou verzi. Skillů uložených v projektu se aktualizace nedotkne.

Kdo skill nemá, uvidí nejvýš jednou za 24 hodin nápovědu, ať si ho přidá. Popis proměnných prostředí u toho zdůrazňuje, že jde o čistě místní kontrolu bez dotazu na síť a že se do adresářů se skilly nesahá. Umlčí ji HF_HUB_DISABLE_UPDATE_CHECK=1, tedy tatáž proměnná, která už dřív vypínala dotaz na novou verzi v PyPI.

Co v tom souboru stojí

Skill se nestahuje hotový. Sestaví se z nápovědy právě nainstalované verze CLI, takže popisuje přesně ty příkazy, které daný stroj má; ostatní skilly si nástroj bere z úložiště huggingface/skills na Hubu.

Vlastní popis skillu, podle kterého se agent rozhoduje, jestli ho vůbec otevře, je v kódu vypsaný natvrdo a míří hodně široko. Vyjmenovává přihlašování, správu místní cache, úlohy na infrastruktuře Hugging Face, procházení modelů a datových sad i čtení odborných prací, a pak žádá použít skill vždy, když padne slovo Hugging Face nebo když si uživatel přeje cokoli kolem ekosystému Hugging Face a kolem AI a strojového učení obecně (přeloženo z anglického originálu). O dvě věty dál stojí, že se má použít, i když uživatel o příkaz příkazové řádky výslovně nepožádá. Text skillu pak vedle rad k hf doporučuje ještě nástroj hf-mount pro připojení repozitářů jako místního disku, včetně jednořádkové instalace z jiné adresy.

Vedlejší nález: přepínače pro Windows nikdy nedorazily

Při té práci se ukázalo, že dosud doporučený zápis pro předání přepínačů na Windows byl vadný. Tvar irm <adresa> | iex -WithTransformers žádný přepínač nepředá, protože Invoke-Expression takový parametr nemá; přepínače se tedy do skriptu nikdy nedostaly. Dokumentace i nápověda instalátoru proto nově uvádějí & ([scriptblock]::Create((irm <adresa>))) -WithTransformers. Vedlejší důsledek je, že přepínač pro odmítnutí skillu funguje na Windows jen v tomhle novém tvaru.

Podstata změny je jinde než v seznamu příkazů: instalace nástroje příkazové řádky se stala i zásahem do nastavení agentů, které má uživatel na stroji. Pojistky kolem toho stojí tři: výpis do terminálu, přepínač a pravidlo, že se odmítnutí samo neruší. Adresář ~/.agents/skills je přitom z podstaty sdílený a jeho obsah čte víc různých programů, takže po téhle změně nemusí uživatel vědět, který instalátor mu tam co položil. Jediný spolehlivý způsob, jak to zjistit, je do něj nahlédnout.

Zdroje: poznámky k vydání huggingface_hub 1.27.0, návrh změny č. 4608, zdrojový text instalačního skriptu, návod Hugging Face CLI for AI Agents a záznam vydání v PyPI.