Portafolio en GitHub para buscar trabajo: perfil, README y proyectos que se entiendan

Un portafolio en GitHub no debería obligar a quien lo visita a adivinar qué has hecho. Necesita una presentación breve, proyectos seleccionados y explicaciones que permitan entender el problema, tu intervención y el resultado. Subir muchas carpetas sin contexto no demuestra mejor preparación.

Si buscas empleo técnico desde España, puede servir como complemento del currículum cuando el puesto permite mostrar código, pruebas o análisis. No sustituye los requisitos de una oferta ni garantiza entrevistas. Esta guía revisa documentación de GitHub consultada el 26 de octubre de 2026.

Empieza por el trabajo que quieres demostrar

Fundación Telefónica incluyó el desarrollo de software entre los perfiles destacados en España el 11 de mayo de 2026. Ese contexto justifica preparar pruebas de habilidades, pero no demuestra que todas las empresas exijan GitHub ni que valoren lo mismo en cualquier candidatura.

Elige el tipo de puesto y revisa qué tareas aparece que tendrás que realizar. Para desarrollo web interesa mostrar una aplicación comprensible; para pruebas, casos reproducibles y resultados; para análisis, procedencia de datos, cálculos y comprobaciones. No necesitas que un único perfil demuestre todas las profesiones digitales.

Escribe una frase privada antes de publicar: «Quiero que se vea que sé resolver esta tarea y explicar estas decisiones». Úsala para descartar proyectos que no aportan una prueba relacionada con tu objetivo.

Configura una presentación breve en tu perfil

GitHub permite añadir un README de perfil. Para mostrarlo, el repositorio debe ser público, tener el mismo nombre que tu usuario y contener un archivo README.md con contenido en su raíz. La función no está disponible para cuentas de usuario administradas.

Si todavía no existe ese repositorio, abre Nuevo repositorio, utiliza tu nombre de usuario como nombre, selecciona Público y activa Agregar README. Después crea el repositorio y edita el archivo. Si ya existe, revísalo antes de crear nada más: no necesitas duplicar tu presentación.

Cuenta en pocas líneas qué estás aprendiendo o qué trabajo sabes hacer, qué proyectos debería revisar la persona y cómo contactar contigo por un canal profesional que quieras hacer público. No añadas teléfono personal, domicilio o información sensible por completar una plantilla.

Si estás empezando, dilo con claridad. Es mejor presentar un proyecto de aprendizaje bien explicado que atribuirte experiencia de una empresa inexistente. Tampoco necesitas llenar la presentación de insignias que no sabes justificar.

Selecciona proyectos, no una cantidad de actividad

Empieza por dos o tres muestras que puedas explicar. Una puede enseñar cómo organizas el trabajo y otra cómo compruebas el resultado. No hace falta utilizar todos los espacios disponibles ni fabricar actividad diaria para que el perfil parezca lleno.

Como propuesta de selección, busca un proyecto pequeño terminado, otro que incluya pruebas y una mejora propia de un ejercicio guiado. Indica cuál es el origen de cada uno y qué partes realizaste tú. Si hay colaboradores, atribuye sus aportaciones.

Un tutorial puede servir para aprender, pero repetirlo no demuestra todas las decisiones que tomó su autor. Para mostrar comprensión, prepara una modificación concreta y explica qué cambió, qué problema resolviste y qué tuviste que comprobar.

Escribe un README útil para cada proyecto

Propón un recorrido sencillo: problema, solución, puesta en marcha, comprobaciones y límites. La primera pantalla debería permitir decidir si merece la pena seguir leyendo. Las instrucciones posteriores deben ayudar a reproducir el trabajo sin adivinar pasos.

• Problema: qué necesidad intenta resolver el proyecto.
• Alcance: qué hace y qué queda fuera.
• Tu aportación: decisiones, cambios y responsabilidades reales.
• Uso: requisitos e instrucciones que hayas comprobado.
• Verificación: pruebas, ejemplos y resultados observables.
• Límites: errores conocidos y mejoras pendientes.

Ejemplo hipotético: una aplicación de inventario para una tienda ficticia puede mostrar altas de productos, cambios de existencias y validación de entradas. Explica que utiliza datos simulados y qué sucede con un valor incorrecto. No la presentes como un sistema implantado en una empresa real.

Para una muestra de pruebas, describe qué comportamiento esperabas, qué caso ejecutaste y qué ocurrió. Si no has medido velocidad, accesibilidad o cobertura, no inventes porcentajes. Una limitación reconocida ayuda a entender el alcance del trabajo.

Destaca las muestras que quieres que vean primero

La función de elementos fijados permite destacar hasta seis repositorios o gists. Desde Tu perfil, entra en Customize your pins, selecciona las muestras y guarda con Save pins. Puedes ordenar su presentación.

Coloca primero lo más relacionado con tu candidatura. Si estás optando a un puesto de desarrollo web, no obligues a buscar la aplicación relevante entre ejercicios de otros temas. Comprueba títulos y descripciones desde el perfil, no solo dentro de cada repositorio.

Las capturas pueden explicar la interfaz, pero no sustituyen instrucciones ni prueban que el programa funcione. Si incluyes una demostración externa, ábrela y confirma que el enlace corresponde a la versión que describes.

Revisa la privacidad antes de hacerlo público

No publiques credenciales, tokens, contraseñas, datos de clientes ni código que no tengas derecho a compartir. Una captura también puede revelar nombres, direcciones o información de una aplicación real. Utiliza material ficticio o autorizado.

La documentación de GitHub sobre datos confidenciales advierte de que eliminar información del historial es una operación compleja. Si se ha filtrado una credencial, el primer paso es revocarla o rotarla. Borrar una línea en un cambio posterior no debe tratarse como una garantía de haber retirado todas las copias.

Antes de publicar, revisa archivos de configuración, imágenes y documentación. Si el proyecto procede del trabajo, pide autorización específica. No asumas que quitar el logotipo de una empresa convierte su material en una muestra personal.

Conecta el portafolio con tu currículum

Incluye el enlace del proyecto más pertinente y una descripción breve de tu intervención. Si presentas también competencias de IA, nuestra guía sobre habilidades de IA en el currículum con ejemplos demostrables explica cómo distinguir herramientas utilizadas de capacidades que puedes acreditar.

Antes de enviar una candidatura, abre los enlaces sin tu sesión, comprueba que las muestras elegidas son públicas y ensaya una explicación de pocos minutos. El objetivo no es impresionar con cantidad: es que otra persona entienda qué sabes hacer y pueda preguntarte por ello.

Portada ilustrativa de código, no captura de GitHub: Arnold Francisca en Unsplash, bajo licencia Unsplash.