Conhecimento
sob demanda.

Skills são instruções reutilizáveis empacotadas em SKILL.md — descobertas do repositório ou da home, listadas ao agente e carregadas só quando a tarefa pede. Contexto grande, custo pequeno.

01Onde o MVCode procura

Nos caminhos de projeto, a descoberta sobe do diretório atual até o worktree Git, carregando toda pasta de skill no caminho. Fontes adicionais (paths e URLs) entram pela chave skills da config — gerenciáveis também pelo diálogo de skills do app.

02Anatomia de uma skill

---
name: git-release
description: Releases e changelogs consistentes
license: MIT
metadata:
  audience: maintainers
---

## O que eu faço
- Rascunho release notes a partir dos PRs mesclados
- Proponho o bump de versão
- Entrego o comando `gh release create` pronto

## Quando me usar
Ao preparar uma release com tag.

• name (obrigatório) — 1–64 chars, minúsculo alfanumérico com hífens simples (^[a-z0-9]+(-[a-z0-9]+)*$), igual ao nome da pasta.
• description (obrigatório) — 1–1024 chars; específica o bastante para o agente escolher certo.
• license, compatibility, metadata — opcionais; campos desconhecidos são ignorados.

03Como o agente usa

As skills disponíveis aparecem na descrição da ferramenta skill — nome e descrição. Quando a tarefa combina, o agente carrega o conteúdo completo:

skill({ name: "git-release" })

04Permissões por padrão de nome

{
  "permission": {
    "skill": {
      "*": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

deny esconde a skill do agente; ask pede aprovação antes de carregar. Overrides por agente valem tanto no frontmatter de agentes customizados quanto na config dos embutidos — e tools.skill: false desliga a ferramenta por completo para um agente.

05Skill não aparece?

• SKILL.md em maiúsculas, dentro de uma pasta com o nome da skill
• Frontmatter com name e description válidos
• Nome único entre todas as fontes de descoberta
• Sem deny nas permissões — skill negada fica invisível