o Zix#@sdZddlZddlZddlmZddlmZmZddlZddl m Z m Z ddl m Z ddlmZdd lmZd Zd Zd Zed ZedZededededdZededededdZeddZdefddZdefddZded eddfd!d"Zd#ed edefd$d%Zd&ed'ed edefd(d)Z ej!d*gd+d, - - - - -  -dDd.eeej"d/d0dfd1eeej"d2d3dfd4eeej"d5d6dfd7eeej"d8d9dfd:eeej"d;deeeej"d?dfd eeej"d@dAdfddfdBdCZ#dS)EaKContains 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.)helpreturncCsBg}|jD]}|jr|jds|jdkr||jqd|S)z?Format required params for a command as uppercase placeholders._z--help )paramsrequiredname startswithZhuman_readable_nameappendjoin)cmdpartsprQ/home/app/Keep/.python/lib/python3.10/site-packages/huggingface_hub/cli/skills.py_format_params^s    rcCs(ddlm}ddlm}t|}t|dd}tt}| d| d|d| d| d | dg}g}t | |D]$}|||}|dusS|j rTqDt |tra| ||fqD| ||fqD|D]-\}}|jpsdd d} t|} d|g| r| gng} | d d | d | qk|D]l\}}|jpdd d} | d| d|d | | dt|||d} | | D]:} || | }|dus|j rq|jpdd d}t|} d|| g| r| gng} | d d | d |qq|td |S)Nr) __version__)appZhf) info_namez!Generated with `huggingface_hub vz-`. Run `hf skills add --force` to regenerate.z ## Commands z- `ru` — z### `hf )parentr!)Zhuggingface_hubrZhuggingface_hub.cli.hfr rrlist_SKILL_YAML_PREFIX splitlinesrsortedZ list_commandsZhidden isinstancerrsplitstriprrextend _SKILL_TIPS)rr Z click_appctxlinesZ top_levelgroupsrr help_textrrZsub_ctxZsub_nameZsub_cmdZsub_helprrrbuild_skill_mdgsR                r2pathforcecCsR|s |s dS|std|d|r#|s#t|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)r3r4rrr_remove_existings r< skills_dircCsL|}|jddd|t}t||||djtdd|S)zYDownload and install the skill files into a skills directory. Returns the installed path.Tparentsexist_okzSKILL.mdzutf-8)encoding) expanduserresolvemkdirDEFAULT_SKILL_IDr< write_textr2)r=r4destrrr _install_tos  rHagent_skills_dircentral_skill_pathcCsD|}|jddd|t}t|||tj|||S)zMCreate a relative symlink from agent directory to the central skill location.Tr>) rBrCrDrEr< symlink_toosr3relpath)rIrJr4 link_pathrrr_create_symlinks  rOadd)zhf skills add --claudezhf skills add --cursorzhf skills add --claude --globalz)hf skills add --codex --opencode --cursor)ZexamplesFr 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.rGz=Install into a custom destination (path to skills directory).z--forcez-Overwrite existing skills in the destination.cCs|s|s|s|s|std|r5|s|s|s|s|r$tdtjddt||}tdtd|dS|r9tnt}g} |rF| |d|rO| |d |rX| |d |ra| |d |ret nt } t| |} tdtd | | D]} t | | |} td | qxdS)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 r rz' to central location: zCreated symlink: ) rprinttyperZExitrHrEGLOBAL_TARGETS LOCAL_TARGETSrCENTRAL_GLOBAL CENTRAL_LOCALrO)r r r rrQrGr4Z skill_destZ targets_dictZ agent_targetsZ central_pathrJZ agent_targetrNrrr skills_adds4%      rY)FFFFFNF)$__doc__rLr9pathlibrtypingrrrTZclickrrZ typer.mainrZhuggingface_hub.errorsrZ _cli_utilsr rEr&r-rXrWrUrVZ skills_clistrrr2boolr<rHrOcommandOptionrYrrrrs         5