Zix#dZddlZddlZddlmZddlmZmZddlZddl m Z m Z ddl m Z ddlmZdd lmZd Zd Zd Zed ZedZededededdZededededdZedZdefdZdefdZdededdfdZd ededefd!Zd"ed#ededefd$Z e!d%gd&' d>d)eeej"d*d+fd,eeej"d-d.fd/eeej"d0d1fd2eeej"d3d4fd5eeej"d6d7d8fd9eeeej"d:fdeeej"d;d<fddfd=Z#dS)?aKContains 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]H}|jr?|jds%|jdkr||jId|S)z?Format required params for a command as uppercase placeholders._z--help )paramsrequiredname startswithhuman_readable_nameappendjoin)cmdpartsps U/root/projects/butler/venv/lib/python3.11/site-packages/huggingface_hub/cli/skills.py_format_paramsr ^sm E Z00 : 0af//44 09NRZ9Z9Z LL. / / / 88E??cddlm}ddlm}t |}t |d}t t}| d| d|d| d| d | dg}g}t| |D]f}|||}||j r"t|tr| ||fO| ||fg|D]\}}|jpdd d} t%|} d|g| r| gngz} | d d | d | |D]G\}}|jpdd d} | d| d|d | | dt |||} | | D]} || | }||j r"|jpdd d}t%|} d|| g| r| gngz} | d d | d |I|t*d |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 B cX^**400399;;  R 777I77888 R#cT:::))'22 B BHoogx88G'. *11$77:@@BBH#G,,F4*&.HvhhbIE LL@sxx@@h@@ A A A A B LL''))*** 99U  r!pathforcec(|s|sdS|std|d|r*|st j|dS|dS)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_existingrLs KKMMT__.. `^D^^^___ {{}}T__.. d r! skills_dirc(|}|dd|tz }t ||||dz 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_torYs&&((0022JTD111 ( (DT5!!!JJLLL J"">#3#3g"FFF Kr!agent_skills_dircentral_skill_pathc|}|dd|tz }t |||t j|||S)zMCreate a relative symlink from agent directory to the central skill location.TrO) rSrTrUrVrL symlink_toosrBrelpath)rZr[rC link_paths r_create_symlinkras'2244<<>>4$777 #33IY&&& );=MNNOOO r!add)zhf skills add --claudezhf skills add --cursorzhf skills add --claude --globalz)hf skills add --codex --opencode --cursor)examplesFr 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|std|rZ|s|s|s|s|r$tdtjdt ||}tdt d|dS|rt nt}g} |r| |d|r| |d |r| |d |r| |d |rtnt} t | |} tdt d | | D]%} t| | |} td | &dS)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 printtyperExitrYrVGLOBAL_TARGETS LOCAL_TARGETSrCENTRAL_GLOBAL CENTRAL_LOCALra)r r rrrdrXrC skill_dest targets_dict agent_targets central_pathr[ agent_targetr`s r skills_addrssJ eeeveeTecddd   %U %f % %G % h i i i*!$$$ $ u--  ?,??:??@@@%,?>>-L "M 5\(3444 4\'2333 5\(34447\*5666%,?>>-L$\599 U( U UAS U UVVV%// #L2DeLL  -)--....//r!)FFFFFNF)$__doc__r^rIpathlibrtypingrrrhclickrr typer.mainrhuggingface_hub.errorsr _cli_utilsr rVr-r6rmrlrjrk skills_clistrr rAboolrLrYracommandOptionrsr!rrs, &&&&&&&& """"""++++++%%%%%%  %&& ())T# $ $d%&&d%&&011 T/ " "d#$$d#$$'((  ] B C C C 322222j 4       D  $     d  T VZ      UZQVTYZ_   38/8/ dLEL:OPPPP Q8/ T<5< 8LMMMM N8/ dLEL:OPPPP Q8/lel<>UVVVVW 8/    ]     8/  P     8/&   @     '8/4 58/8/8/8/8/8/r!