--- title: Skills description: "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? ### 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 | 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 ### 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: | 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 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: ```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** ```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 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 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 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 ### 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 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 **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 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