skill-forge-publish

Publicação e Distribuição de Skills

Processo

Passo 1: Validação Pré-Publicação

Execute a revisão completa antes de publicar:

1. Execute /skill-forge review <caminho> e garanta pontuação >= 80/100
2. Corrija quaisquer problemas críticos ou de alta prioridade
3. Teste com pelo menos 5 consultas de gatilho
4. Verifique se todas as referências cruzadas são resolvidas

Passo 2: Criar Script de Instalação

Gere install.sh que lida com:

#!/usr/bin/env bash
# Script de instalação para [nome-do-skill]
# Uso: bash install.sh

set -euo pipefail

SKILL_DIR="$HOME/.claude/skills"
AGENT_DIR="$HOME/.claude/agents"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

echo "Instalando skill [nome-do-skill]..."

# Criar diretórios
mkdir -p "$SKILL_DIR" "$AGENT_DIR"

# Copiar skill principal
cp -r "$SCRIPT_DIR/nome-do-skill" "$SKILL_DIR/"
echo "  Instalado: nome-do-skill"

# Copiar sub-skills
for skill in "$SCRIPT_DIR/skills"/nome-do-skill-*/; do
    if [ -d "$skill" ]; then
        skill_basename=$(basename "$skill")
        cp -r "$skill" "$SKILL_DIR/"
        echo "  Instalado: $skill_basename"
    fi
done

# Copiar agentes (se houver)
if [ -d "$SCRIPT_DIR/agents" ]; then
    cp "$SCRIPT_DIR/agents"/*.md "$AGENT_DIR/" 2>/dev/null || true
    echo "  Agentes instalados"
fi

echo ""
echo "Instalação completa!"
echo "Teste com: /nome-do-skill"

Passo 3: Criar README.md (nível do repositório, NÃO dentro da pasta do skill)

# [Nome do Skill]

[Descrição de 1 a 2 frases focando em resultados, não em recursos]

## O que faz

[Lista de marcadores com as principais capacidades]

## Instalação

### Claude Code

git clone https://github.com/[usuario]/[repositorio] cd [repositorio] bash install.sh

### Claude.ai
1. Baixe a versão mais recente (.zip)
2. Vá em Configurações > Capacidades > Skills
3. Clique em "Enviar skill"
4. Selecione o arquivo .zip baixado

## Comandos

| Comando | Descrição |
|---------|-----------|
| `/nome-do-skill` | [descrição] |
| `/nome-do-skill cmd` | [descrição] |

## Exemplos

### [Título do Exemplo 1]

Usuário: "[exemplo de entrada]"

[Descrição do que acontece e resultado esperado]

## Arquitetura

[diagrama de árvore de arquivos]

## Licença

[Tipo de licença]

Passo 4: Empacotar para Distribuição

Para upload no Claude.ai: Execute python scripts/package_skill.py <caminho> <diretorio-saida> para criar um arquivo .skill zip.

Para GitHub:

1. Crie repositório com README.md na raiz
2. Pasta(s) do skill na raiz
3. install.sh na raiz
4. Adicione arquivo LICENSE
5. Adicione .gitignore (excluir .tmp/, pycache/, *.pyc)

Para implantação em equipe (admin Claude.ai):

• Skills podem ser implantados em todo o workspace por administradores
• Empacote como .skill zip e faça upload pelo console administrativo

Passo 5: Criar .gitignore

__pycache__/
*.pyc
*.pyo
.tmp/
*.egg-info/
dist/
build/
.env
*.skill

Passo 6: Checklist de Lançamento

• Todos os arquivos validados (pontuação >= 80)
• install.sh testado em sistema limpo
• README.md cobre instalação, uso e exemplos
• Arquivo LICENSE incluído
• .gitignore configurado
• Nenhum segredo ou chave de API em qualquer arquivo
• Consultas de teste documentadas
• Versão etiquetada (se usando git)

Passo 7: Pós-Publicação

Após publicar:

1. Teste a instalação do zero em um ambiente limpo
2. Execute todas as consultas de teste de gatilho
3. Colete feedback inicial dos usuários
4. Planeje a primeira iteração com base no feedback
5. Configure modelos de issue para relatórios de bugs

Canais de Distribuição

Canal	Melhor Para	Formato
GitHub	Código aberto, comunidade	Repositório + install.sh
Upload Claude.ai	Uso pessoal	.skill zip
Admin de equipe	Organização inteira	.skill zip via console administrativo
Claude Plugin Marketplace	Distribuição ampla	manifesto .claude-plugin/