Skip to content

[CLI] Add hf skills list command#4180

Merged
hanouticelina merged 3 commits into
mainfrom
cli-skills-list
May 12, 2026
Merged

[CLI] Add hf skills list command#4180
hanouticelina merged 3 commits into
mainfrom
cli-skills-list

Conversation

@Wauplin

@Wauplin Wauplin commented May 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Add hf skills list (alias hf skills ls) to list available skills from the Hugging Face marketplace.
  • Shows name, description, and install status across all four locations (project, global, project claude, global claude).
  • Add description field to MarketplaceSkill dataclass (parsed from marketplace.json).
$ hf skills ls
  name                        description                                            project   global   project (claude)   global (claude)
  huggingface-llm-trainer     Train or fine-tune language models using TRL on...                yes      yes
  huggingface-gradio          Build Gradio apps on Hugging Face Spaces...
  hf-cli                      Hugging Face Hub CLI...                                 yes       yes      yes                yes
  ...

🤖 Generated with Claude Code


Note

Low Risk
Low risk: adds a new read-only CLI command and extends marketplace parsing with an optional description field, without changing install/update behavior.

Overview
Adds a new hf skills list (alias ls) command that fetches marketplace skills and prints a table including name/description plus whether each skill is installed in the four supported locations (project/global and Claude project/global).

Extends marketplace parsing by adding an optional description field to MarketplaceSkill, and updates the generated CLI reference docs to include the new command.

Reviewed by Cursor Bugbot for commit 2f293ce. Bugbot is set up for automated code reviews on this repo. Configure here.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@bot-ci-comment

bot-ci-comment Bot commented May 4, 2026

Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

**Usage**:

```console
$ hf skills list [OPTIONS]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see that both are possible, but I would just use one in the docs.

Suggested change
$ hf skills list [OPTIONS]
$ hf skills ls [OPTIONS]

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pushed 2f293ce to harmonize (this doc is auto-generated btw)

@tomaarsen

Copy link
Copy Markdown
Member

Nice! I was just looking for this and couldn't find it in the latest release.
Also, should we have a hf skills remove ... just to mirror the add?

  • Tom Aarsen

@hanouticelina hanouticelina left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

Comment thread src/huggingface_hub/cli/skills.py
@hanouticelina hanouticelina merged commit 3d85543 into main May 12, 2026
20 checks passed
@hanouticelina hanouticelina deleted the cli-skills-list branch May 12, 2026 17:10
@huggingface-hub-bot

Copy link
Copy Markdown
Contributor

This PR has been shipped as part of the v1.15.0 release.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants