GitHub Profile README: un perfil que se lee en 10 segundos y dice quién eres

¿Qué es github-profile-readme? ¶

Tu perfil de GitHub es la primera impresión que se llevan un recruiter, un cliente o alguien que acaba de descubrir tu proyecto. Y casi siempre está vacío, o peor: con la plantilla por defecto llena de ... que nadie rellenó.

github-profile-readme monta ese README especial —el del repo tu-usuario/tu-usuario que GitHub pinta arriba del todo de tu perfil— a partir de datos reales. Le das tu username y la skill investiga tu cuenta: bio, repos destacados, lenguajes que más usas, tu web, tus links sociales verificados. Con eso redacta un README en el formato canónico: hero centrado, badges y secciones que se escanean en diez segundos.

No se inventa nada. Si tu perfil público tiene poco que contar, en vez de rellenar con paja te pide material de verdad: tu CV, tu LinkedIn exportado en PDF o la URL de tu portfolio. Lo lee y tira de ahí.

Qué hace, paso a paso ¶

Un perfil se lee por encima, no se estudia. El objetivo de la skill es que quien llega entienda al instante quién eres, qué haces y a dónde ir después. Para eso sigue un proceso, no escupe una plantilla:

• Investiga tu cuenta. Saca bio, repos fijados y top, mezcla de lenguajes y links sociales verificados directamente de GitHub. Verifica cada enlace antes de meterlo.
• Detecta la persona. ¿Eres alguien presentándose o un proyecto/marca? Cambia la estructura y la voz según el caso.
• Rellena los huecos. Si hay poco que mostrar, te pide CV, LinkedIn (PDF) o portfolio en una sola tanda de preguntas. Nunca fabrica experiencia, empleadores ni métricas.
• Escribe el README. Hero con tagline y 3-4 CTAs, secciones con emojis, stack en badges de shields.io (solo de tecnologías que de verdad usas) y una fila de links sociales.

En inglés o en el idioma que quieras ¶

Por defecto el README sale en inglés —es lo que espera el público de GitHub—, pero la skill te pregunta el idioma antes de escribir. Si quieres tu perfil en español, se lo dices y lo redacta en español con los ejemplos adaptados. Y si el repo del perfil aún no existe, te explica exactamente cómo crearlo: el repo público con el nombre exacto de tu usuario (para personas) o el repo .github con el README en profile/README.md (para organizaciones).

Cómo instalar github-profile-readme ¶

Funciona con cualquier agente compatible con el estándar abierto de Agent Skills (Claude Code, Cursor, Codex, OpenCode, Gemini CLI…). Pega esto en tu terminal y listo:

npx skills add webreactiva/skills --skill github-profile-readme

¿La quieres disponible en todos tus proyectos? Añade -g para instalarla global en la carpeta de skills de tu agente (~/.agents/skills, o ~/.claude/skills si usas Claude Code):

npx skills add webreactiva/skills --skill github-profile-readme -g

Es open source. Puedes ver el código fuente en GitHub antes de instalarla.

Preguntas frecuentes ¶

¿Necesito ejecutar scripts raros o dar accesos? ¶

No. Para investigar tu cuenta usa la CLI gh con consultas de solo lectura y te pide permiso antes de ejecutar nada. Trae un script opcional para recopilarlo todo de una vez, pero es opt-in: si no quieres correr un .sh, le pegas tú la info o la saca de tu perfil público.

¿Se va a inventar mi experiencia? ¶

No, y es una regla dura de la skill: todo lo que aparece en el README sale de la investigación o de lo que tú le cuentas (CV, LinkedIn, portfolio). Nunca fabrica empleadores, métricas ni enlaces. Si falta material, te lo pide en vez de rellenar con paja.

¿Sirve para un proyecto u organización, no solo para mí? ¶

Sí. Detecta si presentas a una persona o a un proyecto/marca y cambia la estructura y la voz. Para organizaciones te explica cómo va el repo .github con el README en profile/README.md.

¿Con qué agentes funciona y tiene coste? ¶

Con cualquiera compatible con el estándar abierto de Agent Skills: Claude Code, Cursor, OpenAI Codex, OpenCode, Gemini CLI y más. Es open source: la instalas gratis y el código está en GitHub.