Guía de Envío

Cómo publicar squads en el marketplace a través de la interfaz web.

Dos Formas de Enviar

Puedes enviar squads al marketplace usando una URL de repositorio GitHub o subiendo un archivo ZIP directamente.

Método	Ideal para	Formato del slug
URL de GitHub	Repos públicos, actualizaciones fáciles vía re-envío	owner/repo/squad-name
Subir ZIP	Squads privados, sin repositorio GitHub necesario	username/uploads/squad-name

Enviar vía URL de GitHub

1Inicia sesión en squads.sh con tu cuenta de GitHub.
2Ve a Dashboard > Enviar.
3Selecciona "URL de GitHub" e ingresa tu repositorio en formato owner/repo.
4Haz clic en "Validar". El sistema obtendrá tu squad y ejecutará la validación.
5Revisa el informe de validación. Corrige errores si el estado es CRITICAL.
6Opcionalmente establece un precio (alterna Gratis/De pago, ingresa monto en USD).
7Haz clic en "Enviar al Marketplace" para publicar.

Enviar vía Subida ZIP

1Inicia sesión en squads.sh con tu cuenta de GitHub.
2Ve a Dashboard > Enviar y selecciona "Subir .zip".
3Arrastra y suelta tu archivo ZIP o haz clic para buscar. Máx 50MB, debe contener squad.yaml.
4Haz clic en "Validar" para ejecutar la validación en el squad subido.
5Revisa el informe, establece el precio si lo deseas y haz clic en "Enviar al Marketplace".

Establecer un Precio

Los squads son gratuitos por defecto. Para vender tu squad, cambia a "De pago" después de la validación e ingresa un precio en USD ($0.99 – $999.99). Debes conectar tu cuenta de Stripe en Dashboard > Configuración antes de vender squads de pago. También puedes cambiar el precio después desde la página Mis Squads.

Entender el Informe de Validación

Después de la validación, verás un informe detallado con una puntuación de 0 a 100 y una insignia de estado:

SAFEPuntuación >= 80, sin errores — Listo para publicar.

WARNINGTiene advertencias pero sin errores bloqueantes — Se puede publicar, pero considera corregir las advertencias.

CRITICALTiene errores o puntuación baja — Debe corregir errores antes de enviar. El botón de envío está deshabilitado.

El informe muestra 6 categorías expandibles (Manifiesto, Estructura, Agentes, Tareas, Workflows, Referencias Cruzadas) con hallazgos individuales que puedes inspeccionar.

Después del Envío

▸Tu squad pasa por una auditoría de seguridad automática. Los resultados son visibles en la página de Auditorías.
▸Ganas 50 XP por publicar un nuevo squad.
▸Para actualizar un squad publicado, envía la misma URL de GitHub o sube un nuevo ZIP. El listado existente se actualizará.
▸Puedes cambiar el precio en cualquier momento desde Dashboard > Mis Squads.

CLI vs Web

Ambos métodos publican en el mismo marketplace. Elige según tu flujo de trabajo:

▸Web — Ideal para feedback visual de validación, publicadores primerizos y envíos puntuales.
▸CLI (squads publish) — Ideal para automatización, pipelines CI/CD y publicación frecuente. Soporta flags --dry-run y --strict.

Consulta la Referencia CLI para el comando publish. CLI Reference