Como usar o skillgist

1. Publicar

Na home você pode colar o conteúdo de um SKILL.md ou enviar a pasta da skill zipada. O zip pode ter a pasta na raiz (minha-skill/SKILL.md) — o diretório é detectado e removido automaticamente.

Formato mínimo do SKILL.md:

---
name: revisao-de-pr
description: Use ao revisar um pull request neste repositório.
---

# Revisão de PR

1. Confira migrations antes do código de aplicação
2. Verifique se testes cobrem o caminho de erro

name precisa ser kebab-case e description é o que faz o Claude decidir acionar a skill — descreva quando usá-la, não só o que ela faz.

2. Compartilhar

Depois de publicar você recebe uma URL curta como http://localhost:3000/s/aB3xK9mQ2p. Quem abrir vê o conteúdo renderizado e os comandos de instalação.

3. Instalar num projeto

Na raiz do projeto:

# macOS / Linux
curl -fsSL http://localhost:3000/i/<id> | sh

# Windows (PowerShell)
iwr -useb http://localhost:3000/i/<id>.ps1 | iex

Por padrão instala em .claude/skills/<nome> (vale só naquele projeto). Para deixar disponível em todos os projetos:

SKILL_DIR=~/.claude/skills curl -fsSL http://localhost:3000/i/<id> | sh

Já existe uma pasta com esse nome? O script para em vez de sobrescrever. Use FORCE=1 se quiser substituir.

Prefere não executar script? Baixe o zip em http://localhost:3000/d/<id>.zip e descompacte dentro de .claude/skills/.

Endpoints

URLO que devolve
/s/<id>página da skill
/s/<id>/raw/<caminho>arquivo cru (text/plain)
/d/<id>.zipa pasta da skill em zip
/i/<id> · /i/<id>.ps1instalador sh / PowerShell
/api/skills/<id>metadados em JSON

Publicar via API

curl -X POST http://localhost:3000/api/upload \
  -F "file=@minha-skill.zip"

# → {"id":"aB3xK9mQ2p","url":"http://localhost:3000/s/aB3xK9mQ2p","editToken":"…"}

Guarde o editToken: é ele que permite excluir a skill depois (DELETE /api/skills/<id> com o header x-edit-token). Quando você publica pelo site, o token fica salvo no seu navegador.

Limites