Introdução ao Agent Skills do Claude: como criar um Skill customizado para infra GKE

Olá pessoal! Tudo bem com vocês? Espero que sim!

Hoje no blog da 4Linux, vou falar sobre um recurso que me chamou bastante atenção no Claude: os Agent Skills. Se você ainda não conhece, bora entender o que é isso e como podemos usar na prática para provisionar infraestrutura no GKE. Bora lá!

O que são Agent Skills?

Agent Skills são capacidades modulares e reutilizáveis que estendem o que o Claude consegue fazer. Pensa assim: em vez de ficar repetindo as mesmas instruções e contextos em várias conversas, você empacota tudo isso em um Skill — e o Claude passa a usar automaticamente quando o assunto é relevante.

A documentação oficial define bem:

Skills são recursos reutilizáveis baseados em arquivos que fornecem ao Claude expertise de domínio específico: fluxos de trabalho, contexto e boas práticas que transformam agentes de uso geral em especialistas.

Na prática, é como contratar um especialista que já conhece os seus padrões, as suas convenções e o seu jeito de trabalhar,sem precisar explicar tudo do zero toda vez.

Como os Agent Skills funcionam?

Os Skills trabalham com três níveis de carregamento, o que a Anthropic chama de progressive disclosure:

Nível 1 — Metadata: sempre carregado. É o cabeçalho YAML do SKILL.md com nome e descrição. O Claude sabe que o Skill existe, mas sem custo de contexto.

Nível 2 — Instruções: carregado quando o Skill é acionado. É o corpo do SKILL.md com workflows, boas práticas e orientações.

Nível 3 — Recursos e código: carregado conforme necessário. Scripts, templates, documentação de referência. Tudo disponível no filesystem sem ocupar contexto até ser necessário.

Essa arquitetura é inteligente: você pode ter vários Skills instalados sem penalizar o contexto da conversa.

Onde posso usar?

Os Agent Skills estão disponíveis em três lugares:

• claude.ai — tanto os Skills pré-prontos da Anthropic quanto Skills customizados (planos Pro, Max, Team e Enterprise com code execution habilitado)
• Claude API — via parâmetro container com o skill_id
• Claude Code — baseado em filesystem, sem necessidade de upload via APISkills pré-prontos vs Skills customizados

A Anthropic já oferece Skills pré-prontos para tarefas comuns:

• PowerPoint — criar e editar apresentações
• Excel — criar planilhas e relatórios
• Word — criar e formatar documentos
• PDF — gerar e processar PDFs Mas o mais interessante para nós de infraestrutura são os Skills customizados — onde você define os padrões, convenções e fluxos de trabalho do seu ambiente.

Criando um Skill customizado para provisionar infra GKE

A ideia aqui é criar um Skill que o Claude use automaticamente quando o assunto for provisionar um cluster GKE com Terraform, seguindo os padrões do nosso ambiente.

A estrutura de um Skill é simples:

cronos-gke-skill/
├── SKILL.md        # Instruções principais
├── TERRAFORM.md    # Referência dos módulos
└── scripts/
    └── validate.sh # Script de validação

O SKILL.md sempre começa com um cabeçalho YAML:

---
name: cronos-gke
description: >
  Provisiona clusters GKE Standard na GCP usando Terraform.
  Use quando o assunto for criar ou modificar infraestrutura
  Kubernetes no GCP com Terraform.
---

# Cronos GKE Skill

## Padrões de nomenclatura

Todos os recursos seguem o padrão **cronos**:
- VPC: cronos-vpc
- Cluster: cronos-cluster
- Node Pool: cronos-node-pool

## Infraestrutura padrão

- Região: us-central1
- Nodes: 3 (e2-standard-2)
- Tipo: Standard (não Autopilot)
- Rede: VPC dedicada com Private Nodes

## Fluxo de validação

Nunca executar `terraform apply` diretamente.
Sempre seguir: init → validate → fmt → plan → revisão humana → apply

Simples assim. O Claude passa a carregar esse contexto automaticamente toda vez que o assunto for provisionamento GKE.

Por que isso é útil para DevOps/SRE?

Alguns cenários onde faz sentido:

• Padronização de times — todo mundo usando o mesmo Skill garante que o Claude sempre sugere código seguindo as convenções da empresa
• Onboarding — novos membros do time têm acesso imediato às boas práticas empacotadas no Skill
• Redução de erros — o Skill pode incluir checklists e validações obrigatórias antes de qualquer apply
• Reutilização — cria uma vez, usa em todas as conversas relevantesImportante: IA gera, humano valida

Um ponto que considero essencial destacar: o Skill é uma ferramenta de apoio, não de substituição do julgamento humano.

No nosso cenário com o GKE, o fluxo correto é:

1. Claude gera a infra baseado no Skill
2. Você revisa o terraform plan antes de qualquer coisa
3. Só depois executa o apply Nunca executar cego. O Skill ajuda a padronizar e acelerar — mas a responsabilidade pela infraestrutura continua sendo sua.

Próximos passos

Nos próximos posts vou mostrar na prática como subir esse Skill no claude.ai e executar o provisionamento do cluster GKE com Terraform, mostrando cada etapa do processo.

Compartilhe em suas redes sociais!

https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview