Rework agents docs: simplify, fix links, update skills#2282
Conversation
Document the `hf skills add --claude --global` command as a quick install option before the existing plugin-based instructions.
|
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. |
The `hf skills add` command only installs the hf-cli skill, so it belongs on the CLI-specific page rather than the general skills page.
This is the best onboarding path for agents on the Hub. Tightened the intro and restructured around install CLI → add skill → use it.
Replace inline CLI install instructions with a link to the existing guide. Add `hf skills add` as the primary way to install the CLI skill.
Rewrite agents.md as a concise hub page with a navigation table, condensed tiny-agents/Gradio/smolagents sections, and no duplicated content. Fix 4 broken links in agents-overview.md (./agens-* -> ./agents-*).
Standardize link ordering to CLI, MCP Server, Skills, SDK across agents-overview.md. Add CLI skill tip to top of agents-skills.md. Move CLI before MCP Server in agents.md table.
gary149
changed the title
hf skills add quick install to Skills page
| ## Available Skills | ||
|
|
||
| Hugging Face Skills are available in the [Hugging Face Skills repository](https://github.com/huggingface/skills) and include two types of skills: | ||
| | Skill | What it does | |
There was a problem hiding this comment.
Not for this PR, but do we have a way to generate this content from the skills repo, else it's a constant maintenance churn (or include it, or just link to)?
There was a problem hiding this comment.
yes let's do that later also I'll update to use your installer as default it's going to be way nicer.
There was a problem hiding this comment.
imo this page should be the main section page (i.e. changing line 437 in _toctree.yml from agents -> agents-overview). we can move agents.md into a subsection (Agents libraries?)
There was a problem hiding this comment.
yes I agree in another PR because it's already a lot of changes here.
Co-authored-by: Julien Chaumond <julien@huggingface.co>
5 participants
Summary
hf skills addquick install, tightened intro copy./agens-*→./agents-*), reordered link lists consistentlyCross-cutting: standardized link ordering (CLI, MCP Server, Skills, SDK) across all pages, removed duplicated content, removed
--helpterminal dumps and informal tone.Test plan
Note
Low Risk
Docs-only changes (copy, links, and navigation) with no runtime or security impact; main risk is broken/misleading links if any references were missed.
Overview
Reworks the Hub Agents documentation to be more navigable and consistent: adds quick navigation tables, standardizes link ordering across pages, and fixes broken
./agens-*links.Updates the CLI and Skills guides to reflect current recommended installs and naming: renames the CLI page to "Hugging Face CLI for AI Agents", replaces long install/usage blocks with
hf skills addand updated Claude plugin instructions (hf-cli@huggingface/skills), and expands the Skills page to a fuller curated list with updated install steps for Claude Code/Codex/Gemini CLI/Cursor. The Agents landing page (agents.md) is heavily condensed into a short entrypoint with pointers totiny-agents, Gradio MCP, andsmolagents, and navigation (_toctree.yml,index.md) is updated to surface the CLI page earlier with the new title.Written by Cursor Bugbot for commit 90c0a3c. This will update automatically on new commits. Configure here.