# Habilidades

> [!TIP]
> Procurando a Skill `hf` da CLI? É a maneira mais rápida de conectar seu agente ao Hugging Face Hub e ao ecossistema. Consulte o guia [Hugging Face CLI for AI Agents](./agents-cli).

O Hugging Face oferece um conjunto curado de Skills criados para desenvolvedores de IA. Treine modelos, crie conjuntos de dados, execute avaliações e acompanhe experimentos. Cada Skill é um `SKILL.md` autossuficiente que seu agente segue ao trabalhar na tarefa.

Skills funcionam com todos os principais agentes de código: Claude Code, OpenAI Codex, Google Gemini CLI e Cursor. Saiba mais sobre o formato em [agentskills.io](https://agentskills.io).

## Instalação

```bash
# install a specific Skill with the hf CLI (use --global to install it for all projects)
hf skills add <skill-name> --global
```

A Skill `hf-cli` também está disponível como um plugin do Claude Code:

```bash
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface-skills
```

Copie ou crie links simbólicos para as skills do [repositório](https://github.com/huggingface/skills) em um dos locais padrão de `.agents/skills` do Codex (por exemplo, `$REPO_ROOT/.agents/skills` ou `$HOME/.agents/skills`). O Codex as descobre automaticamente por meio do padrão Agent Skills.

Alternativamente, use o [`agentsmd/AGENTS.md`](https://github.com/huggingface/skills/blob/main/agentsmd/AGENTS.md) incluído como alternativa.

```bash
gemini extensions install https://github.com/huggingface/skills.git --consent
```

Instale por meio do fluxo de plugin do Cursor usando a [URL do repositório](https://github.com/huggingface/skills). O repositório inclui os manifests `.cursor-plugin/plugin.json` e `.mcp.json`.

## Habilidades Disponíveis

| Habilidade | O que ele faz |
| ----- | ------------ |
| [`hf-cli`](https://github.com/huggingface/skills/tree/main/skills/hf-cli) | Operações no Hub via CLI `hf`: download, upload, gerenciamento de repositórios, execução de jobs |
| [`huggingface-datasets`](https://github.com/huggingface/skills/tree/main/skills/huggingface-datasets) | Explore datasets, paginate rows, search text, apply filters |
| [`huggingface-llm-trainer`](https://github.com/huggingface/skills/tree/main/skills/huggingface-llm-trainer) | Treine ou ajuste finamente LLMs com TRL (SFT, DPO, GRPO) nos HF Jobs |
| [`huggingface-vision-trainer`](https://github.com/huggingface/skills/tree/main/skills/huggingface-vision-trainer) | Treinar modelos de detecção de objetos e classificação de imagens |
| [`huggingface-community-evals`](https://github.com/huggingface/skills/tree/main/skills/huggingface-community-evals) | Execute avaliações contra modelos no Hugging Face Hub em hardware local |
| [`huggingface-trackio`](https://github.com/huggingface/skills/tree/main/skills/huggingface-trackio) | Acompanhe e visualize experimentos de treinamento de ML com Trackio |
| [`huggingface-papers`](https://github.com/huggingface/skills/tree/main/skills/huggingface-papers) | Consulte e leia as páginas de artigos do Hugging Face em markdown |
| [`huggingface-paper-publisher`](https://github.com/huggingface/skills/tree/main/skills/huggingface-paper-publisher) | Publique e gerencie artigos de pesquisa no Hub |
| [`huggingface-tool-builder`](https://github.com/huggingface/skills/tree/main/skills/huggingface-tool-builder) | Crie scripts reutilizáveis para operações da API do HF |
| [`gradio`](https://github.com/huggingface/skills/tree/main/skills/huggingface-gradio) | Crie interfaces web e demonstrações do Gradio |
| [`transformers-js`](https://github.com/huggingface/skills/tree/main/skills/transformers-js) | Execute modelos de ML em JavaScript/TypeScript com WebGPU/WASM |

## Usando Skills

Depois de instalado, mencione a Skill diretamente no seu prompt:

- Use a Skill do treinador de modelos do HF para fazer fine-tuning do Qwen3-0.6B com SFT no dataset Capybara
- "Use a Skill de avaliação do HF para adicionar resultados de benchmark ao meu model card"
- Use a Skill de datasets do HF para criar um novo dataset a partir desses exemplos

Seu agente carrega automaticamente as instruções e os scripts auxiliares correspondentes do `SKILL.md`.

## Recursos

- [Repositório de Habilidades](https://github.com/huggingface/skills) - Navegue e contribua
- [Formato Agent Skills](https://agentskills.io/home) - Especificação e documentação
- [Guia de CLI](./agents-cli) - Hugging Face CLI para Agentes de IA
- [Guia do MCP](./agents-mcp) - Use junto com Skills