🔌 Skills no Cline & OpenCode

O Cline (anteriormente conhecido como Claude Dev) e uma extensao open-source para VS Code que transforma qualquer LLM em um agente de codigo completo. Diferente do Copilot que usa exclusivamente modelos da OpenAI/GitHub, o Cline suporta Claude, GPT-4, modelos locais via Ollama e outros providers.

O Cline pode ler e editar arquivos, executar comandos no terminal, navegar na web e interagir com o sistema operacional. Tudo com aprovacao do usuario a cada passo, mantendo o humano no controle do loop de execucao.

A partir da versao 3.48, o Cline adicionou suporte experimental para leitura de SKILL.md. O agente agora pode descobrir e aplicar skills definidas no repositorio, seguindo o mesmo padrao universal usado por outras plataformas.

Este suporte ainda esta em fase experimental, o que significa que nem todos os campos do frontmatter sao processados e pode haver inconsistencias. Porem, o corpo do Markdown (instrucoes) e lido corretamente, tornando skills basicas plenamente funcionais.

// settings.json do VS Code
{
  "cline.experimental.skills": true,
  "cline.experimental.skillsDirectory": ".skills",
  "cline.experimental.autoLoadSkills": true
}

// Estrutura do projeto
meu-projeto/
├── .skills/
│   └── SKILL.md        # Skill principal
├── SKILL.md             # Tambem funciona na raiz
└── src/

Configurar skills no Cline e OpenCode requer ativar flags experimentais e posicionar os arquivos corretamente. O processo e simples, mas pequenos detalhes fazem diferenca entre uma skill que funciona e uma que e ignorada.

O OpenCode e um CLI agent open-source (similar ao Claude Code mas independente de provider) que suporta um sistema de plugins para estender funcionalidades. Plugins podem incluir skills, ferramentas customizadas e integracoes.

O sistema de plugins do OpenCode permite ir alem de instrucoes estaticas: voce pode definir comandos customizados, hooks de pre/pos-processamento e integracoes com ferramentas externas. Skills SKILL.md sao tratadas como um tipo de plugin.

# opencode.config.yaml
plugins:
  - name: my-skill
    type: skill
    path: ./SKILL.md
  - name: lint-hook
    type: hook
    trigger: pre-commit
    command: "npm run lint"
  - name: test-runner
    type: command
    alias: "/test"
    command: "npm test -- --coverage"

A compatibilidade do Cline e OpenCode com o padrao SKILL.md e parcial mas funcional. Os elementos mais importantes (description, corpo do markdown) funcionam bem. Campos avancados podem ser ignorados.

Ao usar skills no Cline e OpenCode, voce pode encontrar problemas comuns que tem solucoes conhecidas. Aqui estao os mais frequentes e como resolve-los.