Skills

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?

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

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

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

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

O Verdent vem com um conjunto de Skills integradas que cobrem fluxos de trabalho comuns:

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

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

SKILL.md é o arquivo central da Skill, contendo o frontmatter YAML e um corpo em 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

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

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:

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

O Verdent oferece suporte a três níveis de escopo de Skills:

Regras de prioridade:

Quando Skills de mesmo nome existem em múltiplos escopos:

• Projeto sobrepõe Global

Skill Store

O Verdent oferece uma Skill Store para navegar e instalar Skills da comunidade e oficiais.

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

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

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

@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

@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

Uso avançado

Incorporando scripts em Skills

Adicione um diretório scripts/ à sua Skill e referencie os scripts em SKILL.md:

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

Armazene documentos, especificações ou código de exemplo do API em um diretório references/ e vincule-os em SKILL.md:

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

Veja também