🏭 Avançado e Contribuição

Um repositório público bem estruturado: README.md rico, skills/ organizado por categoria, .claude-plugin/marketplace.json, CONTRIBUTING.md.

A estrutura correta maximiza a descoberta no skills.sh e facilita contribuições da comunidade.

README.md · skills/ categorizado · marketplace.json · CONTRIBUTING.md · estrutura canônica

Processo: git init, criar repo público no GitHub, push, e aguardar indexação pelo skills.sh. A instalação fica disponível como npx skills add owner/repo.

Publicar no GitHub é tudo que precisa. O skills.sh descobre automaticamente repositórios com skills.

git push · GitHub público · indexação automática · npx skills add owner/repo

O leaderboard é ordenado por install count. Mais instalações = maior ranking. Promover no Twitter/LinkedIn/dev.to acelera o crescimento.

Alta visibilidade no leaderboard cria efeito de rede: mais visibilidade → mais instalações → mais feedback → skills melhores.

install count · leaderboard · promoção · efeito de rede · visibilidade

Boas práticas: semver para releases, changelog por versão, branches feature/, issues para bugs, PRs com reviews.

Um repositório bem mantido retém usuários. Skills desatualizadas são removidas; skills atualizadas são atualizadas com npx skills update.

semver · releases · changelog · branches · issues · PRs · ciclo de vida

Skills públicas: boas práticas genéricas de tecnologia. Skills internas: processos, políticas, informações proprietárias.

Times podem ter um repositório público (boas práticas) e um privado (skills internas). O CLI suporta ambos.

público vs interno · repositório privado · metadata.internal · estratégia de compartilhamento

Skills premium são um modelo emergente: repositórios privados com acesso controlado via GitHub. O CLI suporta repos privados com autenticação.

A medida que o ecossistema cresce, skills especializadas de alta qualidade podem ter valor comercial.

repositórios privados · autenticação GitHub · skills premium · modelo de negócio · acesso controlado

O CLI é TypeScript com módulos: add.ts (instalação), find.ts (descoberta), install.ts (resolução de fonte), sync.ts (atualização).

Entender a arquitetura facilita contribuições. Saber qual arquivo editar para adicionar um novo agente ou corrigir um bug.

TypeScript · add.ts · find.ts · install.ts · sync.ts · arquitetura modular

Resolução: shorthand → GitHub API → clone git → symlink/copy → destino do agente. Para path local: resolve diretamente sem API.

O processo de resolução explica por que algumas instalações são mais lentas (API call, git clone) e outras são instantâneas (path local).

shorthand resolution · GitHub API · git clone · symlink · destino · performance

skill-lock.json rastreia skills de projeto; local-lock.json rastreia globais. Contém: nome, fonte, método (symlink/copy), agentes.

O lock file é a fonte de verdade para npx skills list e npx skills update. Corrompido? Delete e reinstale.

skill-lock.json · local-lock.json · rastreamento · fonte · método · regeneração

DISABLE_TELEMETRY=1 desativa telemetria. INSTALL_INTERNAL_SKILLS=1 mostra skills internas. DEBUG=1 mostra logs detalhados.

Variáveis de ambiente controlam comportamento do CLI. Em CI/CD, DISABLE_TELEMETRY=1 é recomendado para privacidade.

DISABLE_TELEMETRY · INSTALL_INTERNAL_SKILLS · DEBUG · variáveis de ambiente · CI/CD

Para adicionar agente: definir caminhos de instalação, método de detecção, formato de arquivo aceito. Pull request para vercel-labs/skills.

Com 50+ agentes suportados, o processo está bem documentado. Adicionar um novo agente é acessível mesmo para contribuidores novos.

novos agentes · caminhos · detecção · formato · Pull Request · contribuição

Processo: fork o repo, criar branch feature/, fazer mudanças, testes, abrir PR. Issues marcadas good first issue são o melhor começo.

O Skills CLI é um projeto em crescimento rápido. Contribuições são bem-vindas e têm impacto real em um ecossistema crescente.

fork · branch feature/ · PR · good first issue · testes · impacto