🎯 O que sao Agent Skills
Agent Skills sao capacidades modulares e reutilizaveis que estendem a funcionalidade de agentes de IA. Pense nelas como "plugins de conhecimento" - arquivos Markdown que ensinam o agente a executar tarefas especificas de forma consistente.
💡 Conceito Fundamental
Uma skill e um conjunto de instrucoes persistentes que o agente carrega automaticamente quando relevante. Diferente de prompts de sessao, skills ficam disponiveis sempre.
- • Modularidade: Cada skill foca em uma capacidade especifica
- • Descoberta automatica: O agente encontra skills relevantes baseado no contexto
- • Reutilizacao: Uma skill pode ser usada em multiplos projetos
- • Baseado em arquivos: Simples arquivos Markdown, faceis de versionar
📊 Por que Skills importam
- Consistencia: Mesmas instrucoes em todas as sessoes
- Eficiencia: Nao precisa repetir contexto a cada conversa
- Colaboracao: Times podem compartilhar skills padronizadas
- Escalabilidade: Adicione capacidades sem reescrever prompts
🔄 Skills vs Tools vs Prompts
E crucial entender a diferenca entre esses tres conceitos. Cada um tem seu papel no ecossistema de agentes de IA, e saber quando usar cada um maximiza sua eficiencia.
🧠 Skills
O que o agente SABE
- • Conhecimento persistente
- • Carregado automaticamente
- • Instrucoes + contexto
- • Arquivos Markdown
🔧 Tools
O que o agente PODE FAZER
- • Acoes executaveis
- • APIs e funcoes
- • Read, Write, Bash
- • MCP servers
💬 Prompts
Instrucoes DE SESSAO
- • Instrucoes unicas
- • Perdidas ao fechar
- • Contexto temporario
- • Input do usuario
💡 Regra Pratica
Skills ensinam o agente como fazer algo. Tools dao ao agente a capacidade de fazer. Prompts dizem ao agente o que fazer agora. Use skills quando quiser que o agente lembre de algo entre sessoes.
📦 Anatomia de uma Skill
Uma skill tem uma estrutura simples: uma pasta contendo pelo menos um arquivo SKILL.md. Este arquivo usa frontmatter YAML para metadados e Markdown para instrucoes.
Estrutura Minima
skill-name/
├── SKILL.md # Obrigatorio - define a skill
├── scripts/ # Opcional - automacoes
├── resources/ # Opcional - templates, configs
└── examples/ # Opcional - referenciasExemplo de SKILL.md
---
name: timestamp-generator
description: Creates timestamps for files. Use when
user needs to add dates to filenames.
allowed-tools: Bash(date:*)
---
# Timestamp Generator
## When to Use
- User asks to timestamp a file
- User wants date-based organization
## Instructions
1. Use format: YYYY-MM-DD-HH-MM-SS
2. Apply to files or directories
3. Use Bash date command for accuracy✓ Elementos Obrigatorios
- ✓ name: identificador unico
- ✓ description: quando usar
- ✓ Corpo: instrucoes claras
✗ Erros Comuns
- ✗ Nome com espacos ou maiusculas
- ✗ Description vaga ("helps with code")
- ✗ Instrucoes ambiguas ou incompletas
🌐 Ecossistema de Skills
O ecossistema de skills para agentes de IA esta em rapida expansao. Conhecer os principais players ajuda a escolher a plataforma certa e aproveitar recursos existentes.
Anthropic (Claude Code)
Plataforma original de skills
Skills em ~/.claude/skills/ e .claude/skills/. Integracao nativa com Claude Code CLI e Claude.ai Projects. Repositorio oficial: github.com/anthropics/skills
Google (Gemini CLI / Stitch)
Ecossistema Google para skills
AntiGravity framework com B.L.A.S.T. Protocol. Skills em .agent/skills/. Stitch Skills para integracao visual. Repositorio: github.com/google-labs-code/stitch-skills
AgentSkills.io
Especificacao aberta
Padrao aberto para skills cross-platform. Define campos obrigatorios (name, description) e opcionais. Objetivo: interoperabilidade entre plataformas.
Comunidade Open Source
Repositorios e listas awesome
obra/superpowers (framework de desenvolvimento), travisvn/awesome-claude-skills (colecao curada), marketplaces emergentes de skills.
💡 Casos de Uso Reais
Skills ja estao em producao em diversas areas. Conhecer casos de uso reais inspira a criacao de skills proprias e demonstra o potencial da tecnologia.
Document Skills
Geracao de documentos Office
- • Word (.docx) - relatorios, contratos
- • Excel (.xlsx) - dashboards, analises
- • PowerPoint (.pptx) - apresentacoes
- • PDF - documentos formatados
Development Skills
Workflows de desenvolvimento
- • TDD - Test-Driven Development
- • Code Review automatizado
- • Debugging assistido
- • CI/CD integration
Brand Identity Skills
Consistencia visual e de voz
- • Design tokens (cores, fontes)
- • Tom de voz da marca
- • Component library patterns
- • Style guides automatizados
Analytics Skills
Analise de dados e relatorios
- • Sales data analysis
- • Customer insights
- • Financial reporting
- • Market research
🚀 Primeiros Passos
Pronto para comecar? Ha dois caminhos: usar skills existentes ou criar do zero. Recomendamos comecar usando, depois criar.
Explore skills existentes
Visite github.com/anthropics/skills e travisvn/awesome-claude-skills. Leia algumas skills para entender o formato.
Instale uma skill
Copie uma skill para ~/.claude/skills/ (global) ou .claude/skills/ (projeto). Teste se ativa corretamente.
Modifique para suas necessidades
Edite uma skill existente para entender como funciona. Mude instrucoes, adicione contexto.
Crie sua primeira skill
Com o conhecimento adquirido, crie uma skill do zero para uma necessidade real sua.
🎯 Proximo Passo
No proximo modulo, vamos mergulhar na estrutura do arquivo SKILL.md - entendendo cada campo do frontmatter e como escrever instrucoes eficazes.
📚 Resumo do Modulo
Proximo Modulo:
1.2 - Estrutura do Arquivo SKILL.md