SQUADS

Preguntas frecuentes

Preguntas comunes sobre squads.sh y el ecosistema Squad.

¿Qué es un Squad?

Un Squad es un paquete autónomo de agentes IA, tareas, workflows y archivos de configuración diseñados para trabajar juntos en un dominio específico. Los Squads siguen un formato estandarizado definido por el framework Squad, lo que los hace portables y reutilizables entre proyectos.

¿Cómo instalo un squad?

Primero, instala el CLI globalmente. Luego añade un squad desde el marketplace o un repositorio de GitHub. Consulta la Referencia CLI para todas las opciones disponibles.

npm install -g squads
squads add user/squad-name

¿Cómo publico mi squad?

Autentícate con squads login, asegúrate de que tu squad tenga un squad.yaml válido con name, version y description, luego ejecuta squads publish desde el directorio de tu squad. Tu squad pasará por una auditoría de seguridad automatizada.

squads login
squads publish

¿Es gratis?

Sí. squads.sh es gratuito tanto para instalar como para publicar squads. Buscar, explorar y descargar squads no tiene costo. Los publicadores pueden opcionalmente configurar squads de pago a través del marketplace, pero la plataforma en sí es gratuita. El CLI es de código abierto.

¿Cómo funciona la gamificación?

  • ▸XP — Gana puntos de experiencia por publicar squads, recibir instalaciones, obtener reseñas y contribuir actualizaciones.
  • ▸Niveles — Progresa a través de niveles (Novato, Constructor, Arquitecto, Maestro) a medida que acumulas XP.
  • ▸Insignias — Desbloquea insignias de logros por hitos (Primera publicación, 100 instalaciones, Mejor valorado, etc.).
  • ▸Clasificaciones — Compite en rankings semanales y de todos los tiempos visibles en las páginas de Tendencia y En alza.

¿Cómo se realizan las auditorías de seguridad?

Cada squad publicado en el marketplace pasa por una auditoría de seguridad automatizada que verifica:

  • ▸Validez estructural — formato de archivo correcto, campos requeridos, YAML/Markdown válido
  • ▸Integridad de referencias cruzadas — todos los agentes referenciados en tareas y workflows existen
  • ▸Patrones de inyección de prompts — detección de instrucciones potencialmente maliciosas en definiciones de agentes
  • ▸Exposición de datos sensibles — escaneo de secretos hardcodeados, claves API o credenciales

Los resultados de las auditorías son visibles públicamente en la página de Auditorías. Los squads se clasifican como SAFE, WARNING o CRITICAL.

¿Puedo vender mis squads?

¡Sí! El marketplace soporta squads de pago con distribución protegida por servidor. Establece un precio al publicar con squads publish --price 2990 (para $29.90). Necesitarás conectar tu cuenta de Stripe en Dashboard > Configuración primero. Los ingresos se dividen 80% para ti y 20% para la plataforma. Los compradores compran en squads.sh y luego instalan vía CLI. Los squads gratuitos siguen siendo la opción predeterminada y se fomentan para el crecimiento de la comunidad.

¿Qué es Squad y cómo se integra?

Synkra Squad es un framework para desarrollo orquestado por IA. Cuando instalas un squad con la flag --aiox, los agentes se convierten en slash commands en tu IDE (ej. /SQUADS:ds:designer). Esto permite una integración profunda donde puedes invocar agentes directamente desde Claude Code, Gemini CLI u otros IDEs compatibles. Instala Squad Core con npx aiox-core init para empezar.

npx aios-core init

¿Cómo activo squads en mi IDE?

Instala un squad con activación Squad usando squads add my-squad --aiox new (para un nuevo proyecto) o squads add my-squad --aiox existing (para un proyecto Squad existente).

squads add my-squad --aios new
squads add my-squad --aios existing

Después de la activación, los agentes se registran como slash commands siguiendo el patrón /SQUADS:prefix:agent-id. El prefijo se define en squad.yaml (campo slashPrefix). Tu IDE reconoce automáticamente los nuevos comandos.

IDEs soportados: Claude Code (soporte completo), Gemini CLI (alta paridad), Codex CLI (parcial), Cursor (basado en rules).

FAQ — SQUADS