# Skills (/pt/docs/verdent-manager/core-features/skills)
> Amplie as capacidades do Verdent com pacotes de conhecimento reutilizáveis para fluxos de trabalho especializados e expertise de domínio
As **Skills** do Verdent são pacotes de conhecimento reutilizáveis que ampliam a expertise do agente. Cada Skill contém prompts, scripts, referências e boas práticas específicos de domínio. Basta invocar uma Skill pelo nome, e o agente carrega o contexto correspondente e segue o fluxo de trabalho predefinido.
***
## O que são Skills? [#o-que-são-skills]
### Conceito central [#conceito-central]
Uma **Skill** é um pacote de conhecimento estruturado armazenado em uma pasta. Toda Skill contém um arquivo `SKILL.md` que define seu nome, descrição e prompt detalhado. Quando você invoca uma Skill em uma conversa, o Verdent lê esse arquivo e injeta seu conteúdo no contexto do agente.
### Como as Skills diferem de subagentes e MCP [#como-as-skills-diferem-de-subagentes-e-mcp]
| Dimensão | Skills | Subagentes | MCP |
| ----------------- | --------------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------- |
| **Acionamento** | Invocação manual via `@skill` ou menção | Gerado automaticamente pelo agente principal | Invocado automaticamente ou chamado explicitamente |
| **Execução** | Expande o contexto da conversa principal | Roda como uma subtarefa independente com contexto isolado | Chama ferramentas externas via JSON-RPC 2.0 |
| **Finalidade** | Orientação de domínio (ex.: "como escrever testes") | Operações independentes (ex.: "executar revisão de código") | Acesso a dados/ferramentas externas (ex.: consultas a banco de dados) |
| **Ciclo de vida** | Injeção de contexto única | Conclui a subtarefa e então retorna resultados | Processo de servidor persistente durante a sessão |
| **Implementação** | Arquivos Markdown + scripts opcionais | Lógica integrada do agente | Processos de servidor executáveis |
Em resumo: **as Skills fornecem conhecimento e orientação de fluxo de trabalho**, **os subagentes executam tarefas independentes** e **o MCP conecta ferramentas e fontes de dados externas**.
***
## Como usar Skills [#como-usar-skills]
### Invocando uma Skill [#invocando-uma-skill]
Você pode invocar uma Skill de duas formas:
**1. Mencionar o nome da Skill na conversa**
```
Use the skill-creator skill to help me create a new Skill
```
**2. Usar a sintaxe de menção @**
```
@skill-creator help me create a Skill for API documentation generation
```
Quando uma Skill é acionada:
1. O agente chama a ferramenta `skill` para ler o arquivo `SKILL.md` da Skill
2. O conteúdo do arquivo é injetado no contexto da conversa atual
3. O agente continua trabalhando de acordo com a orientação da Skill
### Navegando pelas Skills disponíveis [#navegando-pelas-skills-disponíveis]
Acesse o painel de Skills através das Configurações:
1. Abra o menu **Settings**
2. Selecione a aba **Skills**
3. Navegue pelas Skills instaladas e pelas Skills disponíveis na Skill Store
Você também pode digitar `@` na caixa de entrada para acionar o autocompletar e selecionar rapidamente uma Skill disponível.
***
## Skills integradas [#skills-integradas]
O Verdent vem com um conjunto de Skills integradas que cobrem fluxos de trabalho comuns:
| Skill | Descrição |
| ------------------- | -------------------------------------------------------------------------------------------- |
| **docx** | Ler, criar ou editar documentos do Word (`.docx`) com verificações visuais fiéis ao formato |
| **find-skills** | Descobrir e instalar Skills — use ao perguntar "como faço X?" ou ao buscar novas capacidades |
| **frontend-design** | Criar interfaces frontend distintas e de qualidade de produção com alto padrão de design |
| **pdf** | Ler, criar ou revisar arquivos PDF com renderização visual e extração de conteúdo |
| **pptx** | Ler, criar ou editar apresentações do PowerPoint (`.pptx`) |
| **skill-creator** | Um fluxo de trabalho guiado para criar e iterar sobre Skills personalizadas |
| **xlsx** | Ler, analisar, visualizar e editar de forma inteligente planilhas do Excel |
Mais Skills estão disponíveis na **Skill Store**. Abra **Settings → Skills → Store** para navegar e instalar Skills adicionais.
***
## Criando Skills personalizadas [#criando-skills-personalizadas]
Você pode criar Skills personalizadas para encapsular a expertise de domínio da sua equipe ou fluxos de trabalho específicos do projeto.
### Estrutura de diretório da Skill [#estrutura-de-diretório-da-skill]
Uma pasta de Skill padrão tem esta aparência:
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### Formato do SKILL.md [#formato-do-skillmd]
`SKILL.md` é o arquivo central da Skill, contendo o frontmatter YAML e um corpo em Markdown:
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Fluxo de trabalho
1. Step one
2. Step two
3. ...
## Práticas recomendadas
- Practice suggestion 1
- Practice suggestion 2
```
**Requisitos dos campos do frontmatter:**
* `name` (obrigatório): Deve coincidir com o nome da pasta. Apenas letras minúsculas, números e hífens (`a-z0-9-`) são permitidos. Comprimento: 1–64 caracteres. Sem hífens consecutivos ou no início/fim.
* `description` (obrigatório): Uma descrição curta, máximo de 1024 caracteres.
* `metadata` (opcional): Versão, autor, licença e outras meta informações.
### Instalando Skills personalizadas [#instalando-skills-personalizadas]
**Método 1: Importar via Configurações**
1. Abra **Settings → Skills**
2. Clique em **Import Skill**
3. Selecione a pasta da Skill (ou um arquivo compactado `.zip` / `.skill`)
4. O Verdent valida o `SKILL.md` e o instala em `~/.verdent/skills/`
**Método 2: Cópia manual**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
A Skill fica disponível após reiniciar o Verdent ou atualizar a lista de Skills.
**Método 3: Skill em nível de projeto**
Coloque a Skill dentro do diretório do seu projeto:
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
As Skills em nível de projeto são visíveis apenas dentro daquele projeto e têm prioridade sobre Skills globais de mesmo nome.
***
## Escopos de Skills [#escopos-de-skills]
O Verdent oferece suporte a três níveis de escopo de Skills:
| Nível | Localização | Visibilidade |
| ----------- | ---------------------------- | ---------------------------------------------- |
| **Global** | `~/.verdent/skills/` | Todos os projetos e espaços de trabalho |
| **Projeto** | `/.verdent/skills/` | Apenas os espaços de trabalho do projeto atual |
**Regras de prioridade:**
Quando Skills de mesmo nome existem em múltiplos escopos:
* Projeto sobrepõe Global
***
## Skill Store [#skill-store]
O Verdent oferece uma **Skill Store** para navegar e instalar Skills da comunidade e oficiais.
### Navegando pela Skill Store [#navegando-pela-skill-store]
1. Abra **Settings → Skills**
2. Mude para a aba **Store**
3. Navegue pelas Skills disponíveis ou use a caixa de busca
### Instalando a partir da Store [#instalando-a-partir-da-store]
1. Encontre a Skill desejada na Store
2. Clique em **Install**
3. A Skill é automaticamente baixada e instalada em `~/.verdent/skills/`
**Verificação de segurança:**
As Skills instaladas a partir da Store passam por verificação de checksum SHA256 para garantir a integridade e a segurança dos arquivos.
***
## Exemplos práticos [#exemplos-práticos]
### Exemplo 1: Criar uma nova Skill com `skill-creator` [#exemplo-1-criar-uma-nova-skill-com-skill-creator]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
O agente vai:
1. Ler o conteúdo da Skill `skill-creator`
2. Guiar você no preenchimento do nome da Skill, descrição e prompt central
3. Gerar um `SKILL.md` padrão
4. Sugerir o caminho de instalação e os passos de verificação
### Exemplo 2: Analisar dados com `spreadsheet` [#exemplo-2-analisar-dados-com-spreadsheet]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
O agente vai:
1. Carregar a Skill `spreadsheet`
2. Usar `pandas` e `openpyxl` para ler o arquivo Excel
3. Analisar os dados e gerar visualizações
4. Salvar os resultados ou exibi-los na conversa
### Exemplo 3: Corrigir CI com `gh-fix-ci` [#exemplo-3-corrigir-ci-com-gh-fix-ci]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
O agente vai:
1. Usar a CLI `gh` para recuperar os logs de CI do PR #123
2. Analisar a falha (ex.: erros em casos de teste, problemas de dependência)
3. Propor uma correção
4. Com sua aprovação, modificar o código e enviar a correção
***
## Perguntas frequentes [#perguntas-frequentes]
Quando uma Skill é invocada, o agente lê o arquivo `SKILL.md`, que conta para o uso de tokens e, portanto, consome créditos. No entanto, a própria Skill não faz chamadas adicionais ao API.
Sim. Instale a Skill em `~/.verdent/skills/` (escopo global) e ela ficará disponível em todos os projetos.
Em **Settings → Skills**, clique com o botão direito na Skill e selecione **Delete**. As Skills integradas marcadas como `undeletable` não podem ser excluídas e serão reinstaladas na próxima inicialização.
Sim. O Verdent detecta automaticamente Skills em `~/.cursor/skills`, `~/.claude/skills` e `~/.codex/skills`, e solicita que você as importe. Clique em **Import from External Sources** em **Settings → Skills**.
* **Project Rule**: Instruções sempre ativas, injetadas automaticamente em toda conversa
* **Skill**: Pacotes de conhecimento sob demanda, injetados apenas quando invocados
Use Rules para padrões universais de codificação; use Skills para fluxos de trabalho específicos de domínio.
As Skills instaladas a partir da Skill Store são verificadas automaticamente em busca de atualizações em segundo plano. Skills instaladas manualmente precisam ser reimportadas (sobrescrevendo a versão antiga) para serem atualizadas.
***
## Uso avançado [#uso-avançado]
### Incorporando scripts em Skills [#incorporando-scripts-em-skills]
Adicione um diretório `scripts/` à sua Skill e referencie os scripts em `SKILL.md`:
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
O agente lê essa instrução e executa o script conforme necessário.
### Referenciando documentação [#referenciando-documentação]
Armazene documentos, especificações ou código de exemplo do API em um diretório `references/` e vincule-os em `SKILL.md`:
```markdown
## Documentação de referência
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
O agente pode ler esses arquivos de referência com base nas instruções da Skill.
***
## Boas práticas [#boas-práticas]
**Mantenha as Skills focadas.** Cada Skill deve mirar um único domínio ou fluxo de trabalho. Evite criar Skills "que fazem de tudo" — em vez disso, divida-as em Skills menores e especializadas.
**Use nomes claros.** Os nomes de Skill devem ser concisos e descritivos, ex.: `api-doc-generator` em vez de `my-skill-1`.
**Forneça exemplos e referências.** Inclua exemplos concretos e links de referência em `SKILL.md` para ajudar o agente a entender melhor a saída esperada.
**Mantenha números de versão.** Use o campo `metadata.version` para acompanhar atualizações e compatibilidade.
**Teste antes de compartilhar.** Valide sua Skill em um projeto de teste antes de disponibilizá-la para a equipe ou publicá-la na Skill Store.
***
## Veja também [#veja-também]
Como os subagentes funcionam e como gerenciá-los
Conecte ferramentas e serviços externos via MCP
Configure Project e User Rules sempre ativas
Revise alterações de código com o Reviewer integrado