Configuración de repositorio plantilla en GitHub

Las etapas de ejercicio de código crean un repositorio privado en GitHub para cada candidato a partir de un repositorio plantilla. Esta guía explica cómo configurar correctamente tu repositorio plantilla.

¿Qué es un repositorio plantilla?

Los repositorios plantilla permiten generar nuevos repositorios con la misma estructura de directorios y archivos. Cuando un candidato llega a una etapa de ejercicio de código, Kit usa la API de GitHub para crear una copia privada nueva de tu repositorio plantilla.

Importante: El repositorio de origen debe estar marcado explícitamente como plantilla en GitHub. No se puede usar un repositorio normal como plantilla: la API de GitHub rechazará la solicitud.

Cómo marcar un repositorio como plantilla

1. Ve a tu repositorio en GitHub
2. Haz clic en Settings (icono de engranaje en la navegación del repositorio)
3. En General, busca la sección Template repository cerca de la parte superior
4. Marca la casilla Template repository
5. Haz clic en Save changes (la configuración se aplica de inmediato)

Una vez activado, GitHub mostrará una insignia “Template” en la página del repositorio.

Lista de requisitos

Requisito	Detalles
GitHub App instalada	Tu organización debe tener la Kit GitHub App instalada y activa (Integrations > GitHub)
El repositorio existe	El org/repo especificado en la configuración de la etapa debe existir en GitHub
Marcado como plantilla	El repositorio debe tener “Template repository” activado en Settings > General
La App tiene acceso	La instalación de la Kit GitHub App debe tener acceso al repositorio plantilla
Coincidencia de organización	La instalación de la GitHub App debe cubrir la organización donde se crearán los repositorios de los candidatos

Configurar la plantilla en Kit

1. Ve a tu Job Posting > Stages
2. Selecciona o crea una etapa de Code Assignment
3. En el campo GitHub Template, selecciona un repositorio del desplegable o escribe el nombre org/repo
4. El desplegable solo muestra repositorios ya marcados como plantilla; si tu repositorio no aparece, verifica que esté marcado como plantilla en GitHub
5. Guarda la configuración de la etapa

Kit validará automáticamente que el repositorio sea una plantilla válida después de guardar. Si hay algún problema, aparecerá una advertencia en la tarjeta de la etapa.

Buenas prácticas para repositorios plantilla

• Incluye un README claro con las instrucciones del ejercicio, las expectativas y las directrices de entrega
• Agrega un .gitignore apropiado para el lenguaje y el framework
• Incluye código inicial o boilerplate sobre el que los candidatos deban construir
• Mantenlo mínimo: incluye solo lo que los candidatos necesitan para empezar
• Agrega configuración de CI (GitHub Actions) si quieres pruebas automatizadas en las entregas de los candidatos
• No incluyas secretos, claves de API ni código propietario

Solución de problemas

Problema	Causa	Solución
El candidato se queda en el spinner “Setting Up”	El repositorio plantilla no está marcado como plantilla	Ve a Settings > General del repositorio y marca “Template repository”
Error “Setup encountered an issue”	Repositorio plantilla no encontrado o no es plantilla	Verifica que el repositorio existe y está marcado como plantilla, luego vuelve a iniciar la configuración
El repositorio plantilla no aparece en el desplegable	El repositorio no está marcado como plantilla	Márcalo como plantilla en GitHub Settings y recarga la página
Advertencia “GitHub App not installed”	No hay conexión activa con GitHub	Instala la Kit GitHub App desde la configuración de Integrations
Advertencia “GitHub template repository not set”	El campo github_template está vacío	Selecciona una plantilla en la configuración de la etapa
El candidato no puede acceder a su repositorio	La invitación de GitHub no se envió o no se aceptó	Verifica el nombre de usuario de GitHub del candidato y el estado de la invitación al repositorio

Ver también

• Configuración de plantillas de proceso – Configuración YAML para etapas de ejercicio de código
• Documentación de repositorios plantilla de GitHub