MODULO 9.7

🚀 Deployment de Skills

Como distribuir e instalar seus skills: upload no Claude.ai, instalacao no Claude Code, configuracoes globais e por projeto.

6
Topicos
20
Minutos
Avancado
Nivel
Pratico
Tipo
1

🌐 Claude.ai Upload

O metodo mais simples de deploy e o upload direto no Claude.ai atraves da interface web. Ideal para usuarios sem acesso a terminal.

1

Acesse Settings

No Claude.ai, clique no icone de engrenagem no canto inferior esquerdo.

2

Navegue para Capabilities

Na aba Capabilities voce encontra a opcao de gerenciar skills customizados.

3

Upload do ZIP

Arraste o arquivo .zip ou clique para selecionar. O skill e instalado automaticamente.

Requisito do ZIP

O arquivo SKILL.md deve estar na raiz do ZIP, nao dentro de uma subpasta. Caso contrario, o upload falha.

2

📁 ~/.claude/skills/

Para Claude Code, skills globais ficam em ~/.claude/skills/. Eles estao disponiveis em qualquer projeto.

Estrutura de Diretorios

~/.claude/
├── settings.json
├── CLAUDE.md           # Instrucoes globais
└── skills/
    ├── sales-data-analyzer/
    │   ├── SKILL.md
    │   ├── analyze_sales.py
    │   └── sample_sales.csv
    ├── meeting-notes-extractor/
    │   └── ...
    └── pdf-invoice-parser/
        └── ...

Comando de Instalacao

cp -r sales-data-analyzer ~/.claude/skills/

O skill estara disponivel imediatamente em novas sessoes do Claude Code.

3

📂 Project Skills

Skills especificos de um projeto ficam em .claude/skills/ na raiz do projeto. Sao versionados com o repositorio.

Estrutura do Projeto

meu-projeto/
├── .claude/
│   ├── CLAUDE.md
│   └── skills/
│       └── projeto-skill/
│           └── SKILL.md
├── src/
├── tests/
└── package.json

Vantagens

  • Versionado com Git
  • Compartilhado com a equipe
  • Especifico ao contexto
  • Facilita code review

Comando de Instalacao

cp -r sales-data-analyzer .claude/skills/
4

🔗 API Endpoint

Para integracao automatizada, skills podem ser disponibilizados via endpoints HTTP ou repositorios Git.

Opcoes de Distribuicao

GitHub Releases

Publique skills como releases com assets .zip para download direto.

CDN / S3

Hospede zips em CDN para download rapido e confiavel.

Git Submodules

Adicione skills como submodulos para atualizacoes versionadas.

Exemplo: Download via curl

curl -L https://github.com/org/skills/releases/download/v1.0/sales-data-analyzer.zip \
  -o sales-data-analyzer.zip
unzip sales-data-analyzer.zip -d ~/.claude/skills/
5

🌍 Global vs Local

Entender quando usar skills globais versus locais (por projeto) e crucial para organizacao.

~/.claude/skills/ (Global)

  • Skills de uso geral
  • Analise de dados generica
  • Formatacao e conversao
  • Produtividade pessoal
  • Disponiveis em todos os projetos

.claude/skills/ (Projeto)

  • Skills especificos do projeto
  • Padroes de codigo do time
  • Geracao de componentes
  • Regras de negocio especificas
  • Versionados no repositorio

Prioridade de Carregamento

Se existir um skill com o mesmo nome em ambos os locais, o skill do projeto (.claude/skills/) tem prioridade sobre o global.

6

⚡ Quick Start

Um guia rapido de instalacao e teste para garantir que o skill esta funcionando corretamente.

Checklist de Deploy

1 Copiar skill para o diretorio correto
2 Instalar dependencias (pip install, npm install)
3 Iniciar nova sessao do Claude Code
4 Testar com demo-prompt.txt
5 Validar output esperado

Exemplo Completo

# 1. Copiar skill
cp -r sales-data-analyzer ~/.claude/skills/

# 2. Instalar dependencias
pip install pandas

# 3. Iniciar Claude Code (nova sessao)
claude

# 4. Testar
> Hey Claude, I just added the 'sales-data-analyzer' skill.
> Please analyze the sample_sales.csv file.

📋 Resumo do Modulo

Claude.ai upload - via Settings > Capabilities com ZIP
~/.claude/skills/ - skills globais para todos os projetos
.claude/skills/ - skills locais versionados no projeto
API/Git distribution - automacao de deploy
Local tem prioridade - sobre skills globais
Quick start checklist - validacao rapida

Proximo Modulo:

9.8 - Criando sua Fabrica: Customizacao avancada e skills industry-specific