Skip to content

Conversation

@burtenshaw
Copy link
Collaborator

@burtenshaw burtenshaw commented Jan 6, 2026

This is a WIP proposal for a section on all agents topics in the hub docs. Currently topics like skills, MCP, etc, are spread out around the hub docs and IMO making a 'one stop shop' will encourage users to explore the hub via chat and code agent tools.

⚠️ Just a first draft to get some high-level opinions on the structure and location. I'll iterate further if this is right.

Copy link
Member

@julien-c julien-c left a comment

Choose a reason for hiding this comment

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

i like the content but still think it could live nested under /docs/hub (can be a new toplevel section in /docs/hub though)

@burtenshaw burtenshaw changed the title [WIP] Agents specific section in hub docs [SECTION] Agents specific section in hub docs Jan 16, 2026
@HuggingFaceDocBuilderDev

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.

@burtenshaw
Copy link
Collaborator Author

Thanks for the clarification @julien-c. I've now moved it to a section on agents in hub.

Copy link
Contributor

@merveenoyan merveenoyan left a comment

Choose a reason for hiding this comment

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

gave a super brief review 😊

Your assistant will call MCP tools exposed by the Hugging Face MCP Server (including Spaces) and return results (titles, owners, downloads, links, and so on). You can then open the resource on the Hub or continue iterating in the same chat.

![HF MCP with Spaces in VS Code](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hf-mcp-vscode.png)

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd add docs about experimental options too, and when they're useful, wdyt?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sorry. I don't follow which experimental options?

Copy link
Member

@pcuenca pcuenca left a comment

Choose a reason for hiding this comment

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

🔥

}
}
}
```
Copy link
Member

Choose a reason for hiding this comment

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

Co-authored-by: Pedro Cuenca <pedro@huggingface.co>
burtenshaw and others added 5 commits January 20, 2026 14:16
@@ -0,0 +1,91 @@
# Hugging Face CLI for Agents
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
# Hugging Face CLI for Agents
# Agents and the `hf` CLI

If we go with what's currently in the toc


## Hugging Face Skills for the CLI

Hugging Face Skills are available for the CLI to help you interact with the Hub. Skills give agents relevant instructions for how to use the CLI. See the [Skills Guide](./skills) for available skills and usage.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Hugging Face Skills are available for the CLI to help you interact with the Hub. Skills give agents relevant instructions for how to use the CLI. See the [Skills Guide](./skills) for available skills and usage.
Hugging Face Skills are available for the CLI to help you interact with the Hub. Skills give agents relevant instructions for how to use the CLI. See the [Skills Guide](./agents-skills) for available skills and usage.

xet: xet/index
storage-backends: xet/index
git-xet: xet/using-xet-storage#git-xet
hf-mcp-server: agents/mcp
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
hf-mcp-server: agents/mcp
hf-mcp-server: agents-mcp

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.

6 participants