agentleFS
matheus-rib1108matheus-rib1108/meu-kit-claude-code/skills/criar-skills/publicar-skills-github/SKILL.md

publicar-skills-github

Skill0 starsChanged 27 days agoMITView on GitHub

Monta e publica no GitHub do usuário um repositório público de skills para Claude em português — página explicando cada skill, imagens e vídeo, download de todas ou de uma, instruções de instalação (claude.ai, app, Claude Code), avaliação com estrelas e sugestão de skills novas. Use quando o usuário pedir para colocar skills no GitHub, compartilhar skills, criar repositório/biblioteca/catálogo de skills ou atualizar esse repositório.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Publicar biblioteca de skills no GitHub

0. Regra principal: um repositório só

  • O repositório público é sempre https://github.com/matheus-rib1108/meu-kit-claude-code (local ~/repos/meu-kit-claude-code). Nunca crie outro repositório; o antigo claude-skills-br foi substituído.
  • Skill nova ou alterada: edite em ~/.claude/skills/<nome>/ e rode a skill kit-sync (copia, gera README, passa gitleaks e faz o push). Área/descrição/licença ficam em kit-meta.json.
  • Os .zip para o claude.ai saem sozinhos pelo workflow .github/workflows/zips.yml na release skills (teste local: python scripts/make_zips.py).
  • Texto do README: edite scripts/README.template.md, nunca o README.md direto.
  • A estrutura abaixo é a referência do que o repositório deve ter; o que faltar, acrescente ao kit.

1. Estrutura do repositório

README.md                 # página principal
CATALOGO.md               # skills de terceiros: Skill | Repo (link) | O que faz | Instalar
COMO-INSTALAR.md          # passo a passo com imagens
DICAS.md                  # dicas de uso e como criar a própria skill
skills/<nome>/SKILL.md
skills/<nome>/README.md   # o que faz · o que muda no Claude · exemplos de pedido · antes/depois · dicas
dist/todas-as-skills.zip
dist/<nome>.zip           # pasta da skill na raiz do zip (formato do upload no claude.ai)
docs/images/              # diagramas (como skill funciona, instalação, mapa das skills)
docs/videos/              # demo .mp4 + .gif (gerar com Python/PIL + ffmpeg)
.claude-plugin/marketplace.json
.github/ISSUE_TEMPLATE/avaliar-skill.yml  # dropdown 1–5 estrelas + comentário
.github/ISSUE_TEMPLATE/sugerir-skill.yml
.github/ISSUE_TEMPLATE/problema.yml
.github/workflows/build-zips.yml          # regenera dist/ a cada push
CONTRIBUTING.md
LICENSE                                   # MIT

2. README principal (em pt-BR, bem explicado)

  1. O que são skills (diagrama: descrição curta sempre carregada → instruções completas só quando o assunto aparece).
  2. Tabela de todas as skills: nome com link para o README dela, para que serve, link de download individual.
  3. Botão "⬇ Baixar todas" → dist/todas-as-skills.zip (e Release).
  4. Como instalar:
    • claude.ai / app: Configurações → Capacidades → Skills → enviar o .zip.
    • Claude Code: copiar a pasta para ~/.claude/skills/; ou npx skills add <usuario>/<repo>; ou /plugin marketplace add <usuario>/<repo>.
  5. "Avalie e sugira": links diretos para os templates de issue e para as Discussions.
  6. GIF de demonstração e links para CATALOGO e DICAS.

3. Publicação

  1. gh repo create <usuario>/<repo> --public --source . --push
  2. gh repo edit --enable-discussions --add-topic claude,claude-skills,agent-skills,portugues,brasil
  3. Discussions fixadas: "Avalie as skills" (enquete) e "Ideias de skills".
  4. Release v1.0 com todos os zips anexados — pergunte antes de publicar.

4. Verificação

  • Cada zip abre com uma pasta contendo SKILL.md com name (minúsculas e hífens) e description.
  • README renderizado: todas as imagens aparecem e todos os links funcionam.
  • Nada de e-mail, telefone ou dado pessoal do usuário no repo.

Saída para o usuário

Link do repositório + 3 linhas do que foi feito + como ele pode divulgar.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.