Como publicar no PepeHub

1. Login

A CLI do Pepe autentica via GitHub Device Flow, o mesmo modelo do gh auth login:

1. Rodar pepe skill publish (ou pepe plugin publish) chama POST /api/v1/auth/device/start, que devolve um código de 8 caracteres e um link.
2. Abrir o link, colar o código e aprovar com sua conta do GitHub.
3. A CLI recebe um token de sessão do PepeHub assim que você aprova, e usa esse token em todo publish seguinte.

2. Formato aceito

O artefato enviado é um tarball (.tgz) para plugins ou um zip (.zip) para skills, junto de um manifesto JSON com pelo menos kind, version (semver) e category (uma das categorias fixas do PepeHub).

O formato completo do manifesto, a estrutura interna do pacote e como declarar comandos, hooks etc. estão documentados no site do Pepe, não aqui, para não duplicar conteúdo: skills eplugins.

3. Publicar

pepe skill publish

O namespace do pacote (@seu-handle/nome) precisa começar com o seu handle do GitHub: a primeira publicação de um nome cria o pacote automaticamente.

4. Prefere não usar a CLI?

Também é possível publicar diretamente pelo navegador, enviando o arquivo (.zip ou .tgz) em um formulário: publicar pelo navegador.