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
Revisores conectados	Cada revisor asignado a la etapa debe conectar su propia cuenta de GitHub en Kit; de lo contrario, no tendrá acceso a los repositorios de los candidatos (consulta Acceso de los revisores a 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.

Acceso de los revisores a los repositorios de los candidatos

Los repositorios de los candidatos son privados. Cuando un candidato entrega, Kit invita a los revisores asignados a la etapa a su repositorio con acceso de lectura, por el nombre de usuario personal de GitHub de cada revisor. Kit solo conoce ese nombre de usuario si el revisor ha conectado su propia cuenta de GitHub dentro de Kit.

Conexión	Quién la hace	Qué consigues
Conexión de la organización: Integrations > GitHub	Un administrador, una vez por cuenta	Permite a Kit crear repositorios de candidatos a partir de tu plantilla
Pertenencia a la organización de GitHub: en el propio GitHub	Un propietario de la organización en GitHub	Nada en Kit. Invitar a un revisor a tu organización de GitHub no le da acceso a los repositorios de los candidatos
Conexión personal de GitHub: Configuración > Cuentas conectadas	Cada revisor, una vez por persona	Permite a Kit invitar a ese revisor a los repositorios de los candidatos

Tu organización puede estar completamente conectada y, aun así, ninguno de tus revisores podrá abrir un solo repositorio de candidato.

Revisores: conecta GitHub una vez

1. Abre Configuración > Cuentas conectadas
2. En Conectar un proveedor, haz clic en GitHub
3. Autoriza a Kit en GitHub

Eso es todo, una vez por persona. A partir de entonces, Kit te invita a los repositorios de los candidatos a medida que llegan las entregas, y te pone al día con los que te perdiste: en cuanto conectas, Kit te concede acceso a todos los repositorios de ejercicios de código que ya deberías tener. Nadie tiene que repetir una etapa ni reenviar una invitación.

La primera vez que se te añade como revisor en una etapa de ejercicio de código, Kit te envía un correo de bienvenida. Si tu cuenta de GitHub aún no está conectada, ese correo empieza con un botón Conectar GitHub.

Administradores: localiza a los revisores que faltan

Kit señala la carencia antes de que ningún candidato entregue:

• La sección Revisores de la etapa muestra una advertencia en ámbar que indica exactamente qué revisores no tienen una cuenta de GitHub conectada.
• La etapa lleva un icono de advertencia en la lista de etapas, y la oferta lo cuenta en su resumen de necesita configuración.
• Si un candidato entrega mientras un revisor sigue sin conectar, Kit avisa por correo y en la app tanto a ese revisor como a los responsables de la etapa.

Nadie puede hacerlo por el revisor: ni tú ni un propietario de la organización de GitHub. Pide a cada revisor señalado que siga los tres pasos anteriores, o reasigna la revisión a alguien que ya esté conectado.

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
Un revisor no puede abrir el repositorio de un candidato	Ese revisor no tiene ninguna cuenta personal de GitHub conectada en Kit	Pídele que conecte GitHub en Configuración > Cuentas conectadas; el acceso a los repositorios que se perdió se concede automáticamente en cuanto lo haga
El revisor está en nuestra organización de GitHub pero sigue sin acceso	Pertenecer a la organización no es lo mismo que conectar GitHub en Kit	Misma solución: el propio revisor conecta GitHub en Kit
Instalada en GitHub pero sin conectar en Kit	La app llegó a tu organización, pero GitHub nunca confirmó que seas propietario, así que la instalación sigue en espera	Abre Integrations > GitHub, elige Terminar la conexión y luego Confirmar en GitHub
A la espera de un propietario de la organización	No eres propietario de la organización, así que GitHub envió la instalación a un propietario para que la apruebe	Pide a un propietario que apruebe la Kit GitHub App en GitHub y vuelve a lanzar Instalar GitHub App

Ver también

• Configuración de plantillas de proceso: Configuración YAML para etapas de ejercicio de código
• Evaluaciones y feedback: cómo se asignan y notifican los revisores, y cómo sus votos deciden una etapa
• Documentación de repositorios plantilla de GitHub