$ɷi%VdZddlZddlZddlmZddlmZmZddlZddl m Z m Z ddl m Z ddlmZd Zd Zd Zed Zed ZededededdZededededdZedZdefdZdefdZdededdfdZdededefd Zd!ed"ededefd#Zej?d$d>d%Z ej?d&gd'( d?d)eeejBd*d+fd,eeejBd-d.fd/eeejBd0d1fd2eeejBd3d4fd5eeejBd6d7d8fd9eeeejBd:fdeeejBd;d<fddfd=Z"y)@aContains commands to manage skills for AI assistants. Usage: # install the hf-cli skill in common .agents/skills directory (either in current directory or user-level) hf skills add hf skills add --global # install the hf-cli skill for Claude (project-level, in current directory) hf skills add --claude # install for Cursor (project-level, in current directory) hf skills add --cursor # install for multiple assistants (project-level) hf skills add --claude --codex --opencode --cursor # install globally (user-level) hf skills add --claude --global # install to a custom directory hf skills add --dest=~/my-skills # overwrite an existing skill hf skills add --claude --force N)Path) AnnotatedOptional)ContextGroup) get_command) typer_factoryzhf-clia--- name: hf-cli description: "Hugging Face Hub CLI (`hf`) for downloading, uploading, and managing repositories, models, datasets, and Spaces on the Hugging Face Hub. Replaces now deprecated `huggingface-cli` command." --- Install: `curl -LsSf https://hf.co/cli/install.sh | bash -s`. The Hugging Face Hub CLI tool `hf` is available. IMPORTANT: The `hf` command replaces the deprecated `huggingface-cli` command. Use `hf --help` to view available functions. Note that auth commands are now all under `hf auth` e.g. `hf auth whoami`. a  ## Tips - Use `hf --help` for full options, usage, and real-world examples - Use `--format json` for machine-readable output on list commands - Use `-q` / `--quiet` to print only IDs - Authenticate with `HF_TOKEN` env var (recommended) or with `--token` z.agents/skillsz~/.agents/skillsz~/.codex/skillsz~/.claude/skillsz~/.cursor/skillsz~/.config/opencode/skills)codexclaudecursoropencodez .codex/skillsz.claude/skillsz.cursor/skillsz.opencode/skillsz Manage skills for AI assistants.)helpreturncg}|jD]V}|js|jjdr,|jdk7s<|j |jXdj |S)z?Format required params for a command as uppercase placeholders._z--help )paramsrequiredname startswithhuman_readable_nameappendjoin)cmdpartsps M/var/www/html/venv/lib/python3.12/site-packages/huggingface_hub/cli/skills.py_format_paramsr`sb E ZZ0 ::aff//49N9NRZ9Z LL.. /0 88E?cddlm}ddlm}t |}t |d}t tj}|jd|jd|d|jd|jd |jdg}g}t|j|D]Z}|j ||}| |jr$t|tr|j||fH|j||f\|D]r\}}|jxsdj!d dj#} t%|} d|g| r| gngz} |jd d j'| d | t|D]"\}}|jxsdj!d dj#} |jd|jd|d | |jdt |||} |j| D]} |j | | }| |jr$|jxsdj!d dj#}t%|} d|| g| r| gngz} |jd d j'| d |%|j)t*jd j'|S)Nr) __version__)apphf) info_namez!Generated with `huggingface_hub vz-`. Run `hf skills add --force` to regenerate.z ## Commands z- `ru` — z### `hf )parentr%)huggingface_hubr"huggingface_hub.cli.hfr#rrlist_SKILL_YAML_PREFIX splitlinesrsorted list_commandshidden isinstancerrsplitstriprrextend _SKILL_TIPS)r"r# click_appctxlines top_levelgroupsrr help_textrrsub_ctxsub_namesub_cmdsub_helps rbuild_skill_mdr@is+*C I )t ,C.99; ?  B cXX^**40399;  R xvVI;78 R#cT:))'2 BHoogx8G'.. *11$7:@@BH#G,F4*&vhbIE LL3sxx/vhZ@ A B B LL'')* 99U r pathforcec|js|jsy|std|d|jr&|jst j |y|j y)zRRemove existing file/directory/symlink if force is True, otherwise raise an error.NzSkill already exists at z#. Re-run with --force to overwrite.)exists is_symlink SystemExitis_dirshutilrmtreeunlink)rArBs r_remove_existingrKsW KKMT__. 3D69]^__ {{}T__. d r skills_dirc|jj}|jdd|tz }t |||j|dz j t d|S)zYDownload and install the skill files into a skills directory. Returns the installed path.Tparentsexist_okzSKILL.mdzutf-8)encoding) expanduserresolvemkdirDEFAULT_SKILL_IDrK write_textr@)rLrBdests r _install_torXsj&&(002JTD1 ( (DT5!JJL J"">#3g"F Kr agent_skills_dircentral_skill_pathc|jj}|jdd|tz }t |||j t jj|||S)zMCreate a relative symlink from agent directory to the central skill location.TrN) rRrSrTrUrK symlink_toosrArelpath)rYrZrB link_paths r_create_symlinkr`sg'224<<>4$7 #33IY& );=MNO r previewc*tty)z'Print the generated SKILL.md to stdout.N)printr@r rskills_previewres . r add)z hf skills addzhf skills add --globalzhf skills add --claude --cursorz2hf skills add --codex --opencode --cursor --global)examplesr z--claudezInstall for Claude.r z--codexzInstall for Codex.r z--cursorzInstall for Cursor.rz --opencodezInstall for OpenCode.global_z--globalz-gzJInstall globally (user-level) instead of in the current project directory.rWz=Install into a custom destination (path to skills directory).z--forcez-Overwrite existing skills in the destination.c|rM|s|s|s|s|r!tdtjdt||}tdtd|y|rt nt }t||} tdtd| |rtnt} g} |r| j| d|r| j| d |r| j| d |r| j| d | D]} t| | |} td | y) a0Download a skill and install it for an AI assistant. Default location is in the current directory (.agents/skills) or user-level (~/.agents/skills). If custom agents are specified (e.g. --claude --codex --cursor --opencode, etc), the skill will be symlinked to the agent's skills directory. zT--dest cannot be combined with --claude, --codex, --cursor, --opencode, or --global.r )codez Installed 'z' to Nz' to central location: r r r rzCreated symlink: ) rctyperExitrXrUCENTRAL_GLOBAL CENTRAL_LOCALGLOBAL_TARGETS LOCAL_TARGETSrr`)r r r rrhrWrB skill_dest central_pathrZ targets_dict agent_targets agent_targetr_s r skills_addrvsR UfG h i**!$ $ u-  ,-U:,?@&->-L$\59 K())@AS@T UV&->-L "M \(34 \'23 \(34\*56%/ #L2DeL  !)-./r )rN)FFFFFNF)#__doc__r]rHpathlibrtypingrrrkclickrr typer.mainr _cli_utilsr rUr,r5rnrmrorp skills_clistrrr@boolrKrXr`commandreOptionrvrdr rrs4 & "%  %& ()# $%&%&01 / "#$#$'(   B C 322j 4    D  $  d  T VZ  I   UZQVTYZ_   3;/ dLELL:OPP Q;/ T<5<< 8LMM N;/ dLELL:OPP Q;/lell<>UVVW ;/    ]   ;/  P   ;/&   @   ';/4 5;/;/r