Documentação

Tudo o que você precisa saber sobre squads.sh e AI agent squads.

O que é squads.sh?

squads.sh é o marketplace gamificado para AI agent squads. É uma plataforma onde desenvolvedores e engenheiros de IA podem descobrir, compartilhar, instalar, comprar, vender e publicar squads de agentes IA reutilizáveis. Pense nele como o npm para equipes de agentes IA — cada squad é um pacote autônomo de agentes, tarefas, workflows e configuração que pode ser integrado a qualquer projeto compatível com Squad.

docs.whatIsAiosTitle

docs.whatIsAiosDescription

docs.whatIsAiosLink

O que são AI agent squads?

Um Squad é uma coleção estruturada de agentes IA projetados para trabalhar juntos em um domínio ou tarefa específica. Cada squad inclui:

  • Agentes — Personas de IA especializadas com papéis definidos, estilos de comunicação e capacidades.
  • Tarefas — Unidades atômicas de trabalho com contratos de entrada/saída, checklists e responsabilidades atribuídas.
  • Workflows — Padrões de orquestração que definem como os agentes colaboram, com transições e indicadores de sucesso.
  • Configuração — Padrões de código, definições de stack tecnológica e mapas de estrutura do projeto.

Primeiros passos

Instale o CLI globalmente para começar a usar squads nos seus projetos:

npm install -g squads

1. Buscar squads

Navegue pelo marketplace ou busque por palavra-chave:

squads find "design system"

2. Instalar um squad

Adicione um squad ao seu projeto a partir de um repositório do GitHub ou do marketplace:

squads add user/repo/my-awesome-squad

docs.step2AiosTitle

docs.step2AiosDescription

docs.step2AiosNew

squads add my-squad --aios new

docs.step2AiosExisting

squads add my-squad --aios existing

docs.step2AiosResult

/SQUADS:prefix:agent-id

3. Verificar a instalação

Confira se todos os squads são válidos e estão atualizados:

squads check

Como publicar

Compartilhe seu squad com a comunidade. Autentique-se com o GitHub e depois publique:

squads login
squads publish ./my-squad

Seu squad passará por uma auditoria de segurança antes de ser listado no marketplace. Você pode acompanhar o status da auditoria na página de Auditorias.

Você também pode publicar squads diretamente pela interface web. Dashboard > Submit

Publicar com preço

Você pode vender seu squad no marketplace. Defina um preço em centavos USD ao publicar:

Publicar a $29.90

squads publish --price 2990

Mudar para gratuito

squads publish --price 0

O preço deve ser entre $0.99 e $999.99. Você precisa conectar sua conta Stripe em Configurações antes de vender squads pagos.

Vendendo Squads

squads.sh suporta squads pagos com distribuição server-gated. Quando um squad é pago:

  • O código-fonte é armazenado com segurança nos servidores do squads.sh (não público no GitHub).
  • Compradores devem adquirir via Stripe antes de instalar.
  • A receita é dividida em 80% para o vendedor e 20% para a plataforma.
  • Vendedores devem conectar sua conta Stripe em Dashboard > Configurações.

Comprando um squad

Quando você tenta instalar um squad pago que não comprou, o CLI mostra o preço e um link para comprá-lo no squads.sh. Após a compra, execute o comando de instalação novamente.

docs.aiosTitle

docs.aiosDescription

docs.aiosSlashCommands

docs.aiosInstallCore

npx aios-core init

docs.aiosLearnMore

Sistema de gamificação

squads.sh possui um sistema de gamificação que recompensa contribuidores e incentiva a qualidade:

  • XP e Níveis — Ganhe pontos de experiência publicando squads, recebendo instalações e obtendo avaliações positivas.
  • Badges — Desbloqueie conquistas por marcos como primeira publicação, 100 instalações, squad mais bem avaliado e mais.
  • Rankings — Compita em classificações semanais e gerais em todas as categorias.
  • Sequências — Mantenha sequências de publicação e contribuição para recompensas extras.
Documentação — SQUADS