Skills: Instalação e Configuração do Ambiente

Última atualização: 2026-08-31

Para fazer bem o trabalho, primeiro afie as ferramentas. Configure o ambiente de desenvolvimento de Skills em 5 minutos e deixe o assistente de IA aprender novas habilidades.

1. Requisitos do ambiente

Verifique o ambiente:

node --version    # v20.11.0
git --version     # git version 2.43.0
claude --version  # Claude Code v1.0+ (se usar)

2. Diretórios de Skills por plataforma

(1) Claude Code

# Skills por projeto (recomendado, acompanha o versionamento do projeto)
mkdir -p .claude/skills

# Skills por usuário (compartilhados entre todos os projetos)
mkdir -p ~/.claude/skills

(2) OpenCode

# Skills por projeto
mkdir -p skills

# Skills por usuário
mkdir -p ~/.config/opencode/skills

(3) Cursor Rules

# Regras por projeto
mkdir -p .cursor/rules

3. Padrão de estrutura de diretórios

Uma estrutura de projeto de Skills padronizada:

project/
├── .claude/
│   ├── skills/              # Diretório de skills do Claude Code
│   │   ├── code-review.md   # Skill de revisão de código
│   │   ├── deploy.md        # Skill de deploy
│   │   └── test-gen.md      # Skill de geração de testes
│   └── settings.json        # Configuração do Claude Code
├── skills/                  # Diretório de skills do OpenCode
│   ├── code-review.md
│   └── deploy.md
├── .cursor/
│   └── rules/               # Diretório de regras do Cursor
│       └── review.mdc
└── .gitignore

(1) Formato de Skill em arquivo único

Cada Skill é um arquivo Markdown:

---
name: code-review
description: "Skill de revisão de código, detecta automaticamente problemas de segurança e gargalos de desempenho"
triggers:
  - keyword: "review|revisar"
  - file_pattern: "**/*.{py,ts,js}"
tools:
  - Read
  - Grep
  - Glob
---

# Code Review Skill

Quando o usuário solicitar revisão de código, execute o seguinte fluxo:
1. Leia o arquivo alvo
2. Verifique problemas de segurança
3. Verifique gargalos de desempenho
4. Gere o relatório de revisão

(2) Formato de Skill em múltiplos arquivos

Skills complexos podem ser divididos em vários arquivos:

.claude/skills/code-review/
├── SKILL.md          # Arquivo principal da skill
├── prompts/          # Templates de prompt
│   ├── security.md
│   └── performance.md
├── examples/         # Exemplos
│   └── sample-review.md
└── config.yaml       # Configuração adicional

4. Configurando a ativação de Skills

(1) Carregamento automático

Skills colocados no diretório correspondente ficam automaticamente disponíveis, sem configuração adicional.

(2) Referência manual

Em algumas plataformas, você pode referenciar explicitamente o Skill:

// .claude/settings.json
{
  "skills": [
    "code-review",
    "deploy",
    "test-gen"
  ]
}

(3) Ativação condicional

# Ativar apenas em branches específicos
triggers:
  - condition: "git_branch == 'main'"
  - condition: "file_changed matches '**/api/**'"

5. Verificando o ambiente

Crie um Skill de teste para verificar se a configuração do ambiente foi bem-sucedida:

---
name: hello-skill
description: "Skill de teste, verifica a configuração do ambiente"
triggers:
  - keyword: "hello-skill"
---

# Hello Skill

Quando o usuário disser "hello-skill", responda:

"Configuração do ambiente de Skills bem-sucedida! Projeto atual: {project_name}, ferramentas disponíveis: Read, Write, Bash"

Alice seguiu os passos acima para criar o diretório e o Skill de teste, e ao digitar "hello-skill" viu imediatamente a resposta. Bob disse: "Funciona em 5 minutos, mais simples que configurar CI/CD."

❓ Perguntas Frequentes

P: Qual a diferença entre Skills por projeto e por usuário? R: Skills por projeto ficam no diretório .claude/skills/ do projeto, acompanham o gerenciamento Git e são compartilhados com a equipe; Skills por usuário ficam em ~/.claude/skills/, disponíveis para todos os projetos mas não entram no versionamento. P: Skills de plataformas diferentes são compatíveis entre si? R: A parte central do prompt é compatível, mas a sintaxe de triggers e tool bindings varia por plataforma. Recomenda-se usar Markdown como base, com configurações específicas isoladas em comentários condicionais. P: Qual o padrão para nomes de arquivo de Skill? R: Recomenda-se kebab-case (ex.: code-review.md), com o nome consistente com o campo name, facilitando o gerenciamento.

📖 Resumo

• O local dos diretórios de Skills varia por plataforma, mas a estrutura central é consistente
• Skills em arquivo único usam Markdown + YAML frontmatter para definição
• Skills por projeto acompanham versionamento Git, Skills por usuário são globais
• Use hello-skill para testar se a configuração do ambiente está correta

📝 Exercícios

1. Básico (dificuldade⭐): No assistente de codificação com IA que você usa, crie o diretório de Skills e um hello-skill de teste.
2. Intermediário (dificuldade⭐⭐): Projete uma estrutura de diretório de Skills para o seu projeto, com pelo menos 3 arquivos de skill planejados.
3. Avançado (dificuldade⭐⭐⭐): Escreva um script que detecte automaticamente a plataforma de IA usada no projeto atual e crie o diretório de Skills correspondente com arquivos de exemplo.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós