qi$bdZddlZddlZddlmZddlmZmZddlZddl m Z m Z ddl m Z ddlmZdd lmZd Zd Zd Zed ZedZededededdZededededdZedZdefdZdefdZdededdfdZd ededefd!Zd"ed#ededefd$Z ejCd%d?d&Z"ejCd'gd() d@d*eeejFd+d,fd-eeejFd.d/fd0eeejFd1d2fd3eeejFd4d5fd6eeejFd7d8d9fd:eeeejFd;fdeeejFdZ$y)AaKContains commands to manage skills for AI assistants. Usage: # 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)CLIError) 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 L/opt/pipecat/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 isinstancerrsplitstripr rextend _SKILL_TIPS)r#r$ click_appctxlines top_levelgroupsrr help_textrrsub_ctxsub_namesub_cmdsub_helps rbuild_skill_mdrAgs+*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)rBrCs r_remove_existingrLsW 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_IDrL write_textrA)rMrCdests r _install_torYsj&&(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.TrO) rSrTrUrVrL symlink_toosrBrelpath)rZr[rC link_paths r_create_symlinkrasg'224<<>4$7 #33IY& );=MNO r!previewc*tty)z'Print the generated SKILL.md to stdout.N)printrAr!rskills_previewrfs . r!add)zhf skills add --claudezhf skills add --cursorzhf skills add --claude --globalz)hf skills add --codex --opencode --cursor)examplesr z--claudezInstall for Claude.r z--codexzInstall for Codex.rz--cursorzInstall for Cursor.rz --opencodezInstall for OpenCode.global_z--globalz-gzJInstall globally (user-level) instead of in the current project directory.rXz=Install into a custom destination (path to skills directory).z--forcez-Overwrite existing skills in the destination.c>|s|s|s|s |s td|rM|s|s|s|s|r!tdtjdt ||}tdt d|y|rt nt}g} |r| j|d|r| j|d |r| j|d |r| j|d |rtnt} t | |} tdt d | | D]} t| | |} td | y)z4Download a skill and install it for an AI assistant.zJPick a destination via --claude, --codex, --cursor, --opencode, or --dest.zT--dest cannot be combined with --claude, --codex, --cursor, --opencode, or --global.r )codez Installed 'z' to Nr r rrz' to central location: zCreated symlink: ) r rdtyperExitrYrVGLOBAL_TARGETS LOCAL_TARGETSrCENTRAL_GLOBAL CENTRAL_LOCALra)r r rrrirXrC skill_dest targets_dict agent_targets central_pathr[ agent_targetr`s r skills_addrws,J evTcdd UfG h i**!$ $ u-  ,-U:,?@%,>-L "M \(34 \'23 \(34\*56%,>-L$\59 K())@AS@T UV%/ #L2DeL  !)-./r!)rN)FFFFFNF)%__doc__r^rIpathlibrtypingrrrlclickrr typer.mainrhuggingface_hub.errorsr _cli_utilsr rVr-r6rqrprnro skills_clistrr rAboolrLrYracommandrfOptionrwrer!rrs, & "+%  %& ()# $%&%&01 / "#$#$'(   B C 322j 4    D  $  d  T VZ  I   UZQVTYZ_   38/ dLELL:OPP Q8/ T<5<< 8LMM N8/ dLELL:OPP Q8/lell<>UVVW 8/    ]   8/  P   8/&   @   '8/4 58/8/r!