Skip to content

[CLI] Add hf skills list command#4180

Open
Wauplin wants to merge 2 commits intomainfrom
cli-skills-list
Open

[CLI] Add hf skills list command#4180
Wauplin wants to merge 2 commits intomainfrom
cli-skills-list

Conversation

@Wauplin
Copy link
Copy Markdown
Contributor

@Wauplin Wauplin commented May 4, 2026

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
Copy link
Copy Markdown

bot-ci-comment Bot commented May 4, 2026

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
Contributor 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

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.

3 participants