Communitygithub.com

diegosouzapw/awesome-omni-skill

Construye un portafolio en GitHub que consiga trabajo: selecciona 3 a 5 proyectos pulidos, redacta READMEs atractivos, despliega demos en vivo, cuenta una historia coherente entre tus repositorios y alinea todo con roles de desarrollo nativo en IA. Úsalo al preparar tu GitHub para búsquedas laborales, decidir qué fijar o auditar tu presencia pública.

¿Qué es awesome-omni-skill?

Esta habilidad es una guía estratégica para transformar tu perfil de GitHub en un portafolio profesional orientado a roles de desarrollo nativo en IA. Enseña a curar de 3 a 5 proyectos pulidos, redactar READMEs que vendan en 30 segundos, desplegar demos en vivo y contar una historia coherente a través de tus repositorios. Incluye plantillas de estructura de README, opciones de despliegue gratuito y una lista de verificación de auditoría. Está diseñada para agentes como Claude Code, Cursor y Codex, y se activa automáticamente cuando solicitas revisión de portafolio, análisis de proyectos fijados o evaluación de presencia en GitHub. Su valor principal es transformar un perfil desordenado en un activo profesional que atraiga a reclutadores.

Compatible con✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/diegosouzapw/awesome-omni-skill/tree/HEAD/skills/tools/portfolio-strategy

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Estrategia de Portafolio

Principio Fundamental

Tu GitHub no es un cementerio de proyectos a medio terminar. Es una exhibición curada. Cada repositorio fijado debe responder una pregunta que un reclutador tiene sobre ti, y cada respuesta debe hacer que quieran agendar una entrevista.

Lo que Separa lo Impresionante de lo Mediocre

PORTAFOLIO MEDIOCRE                    PORTAFOLIO IMPRESIONANTE
─────────────────                     ────────────────────────
30 repos, la mayoría forks            5 repos, todo trabajo original
Sin READMEs                            Cada README cuenta una historia
Sin demos en vivo                      Cada proyecto está desplegado
Tutoriales aleatorios clonados         Tema claro y progresión
Último commit: hace 8 meses           Actividad consistente y reciente
Sin descripciones en repos             Cada repo tiene una línea descriptiva
"mi-primer-react-app"                  "Herramienta de revisión de código con IA"

La diferencia no es talento. Es curaduría. Los mejores portafolios parecen de alguien con un plan, no de alguien que sube todo lo que toca.


Calidad sobre Cantidad

De tres a cinco proyectos pulidos vencen a treinta repositorios abandonados. Siempre.

Las Matemáticas que Importan

ReposREADMEsDesplegadosEl Reclutador Piensa
3020"Empieza cosas, no las termina"
1551"Pica aquí y allá. No sabe en qué es bueno"
554"Enfocado. Entrega. Sabe su oficio"
333"Todo lo que toca está pulido"

La Regla de Limpieza

Antes de agregar algo nuevo, audita lo que ya está:

1. Archiva o haz privado lo que esté incompleto e irrecuperable.
2. Elimina forks que nunca modificaste.
3. Agrega READMEs a todo lo que mantengas público.
4. Pon descripciones en cada repositorio visible.
5. Lo que quede debe valer la pena mostrarlo.

Si no lo pondrías en tu currículum, no debería estar en tu GitHub público.


Cuenta una Historia a Través de tus Repos

Tus repositorios fijados no son muestras al azar. Son capítulos. Organízalos para que un visitante vea una narrativa.

Estructuras de Historia que Funcionan

El Arco del Especialista:

"Profundizo en IA/ML y puedo demostrarlo."

Repo 1: LLM ajustado para tarea de dominio específico
Repo 2: Pipeline RAG con marco de evaluación
Repo 3: Flujo de trabajo agéntico con uso de herramientas
Repo 4: Contribución open-source a LangChain/LlamaIndex

El Arco del Desarrollador Full-Stack:

"Construyo productos completos desde la base de datos hasta el despliegue."

Repo 1: App SaaS full-stack (Next.js + API + BD + Auth)
Repo 2: Herramienta CLI con IA (muestra habilidades de backend/sistemas)
Repo 3: Librería open-source (muestra pensamiento de diseño de API)
Repo 4: Herramienta de automatización personal (muestra que también construyes para ti)

El Arco del Desarrollador Nativo en IA:

"No solo uso IA, construyo con ella y para ella."

Repo 1: Flujo de trabajo agéntico / sistema multi-agente
Repo 2: Integración de LLM en una app de nivel de producción
Repo 3: Herramienta de desarrollo que aprovecha IA (linter, revisor, generador)
Repo 4: Contribución a un framework o cadena de herramientas de IA

Señales de Progresión

Los reclutadores notan cuando tus repositorios muestran crecimiento:

SeñalLo que Muestra
Repo temprano: app CRUD simpleEmpezaste por algún lado
Repo intermedio: API con tests y CIAprendiste prácticas de ingeniería
Repo reciente: agente de IA con evaluacionesEstás construyendo en la frontera
Contribución a proyecto OSS importantePuedes trabajar en bases de código grandes

Qué Fijar y Por Qué

Tienes seis repositorios fijados. Úsalos estratégicamente.

La Distribución Ideal de Fijados

RanuraQué FijarPor Qué
1Proyecto full-stackDemuestra que puedes construir un producto completo
2Proyecto de IA/MLMuestra que trabajas en la frontera
3Contribución open-sourcePrueba que colaboras en bases de código reales
4Herramienta de desarrollo o CLIMuestra que resuelves tus propios problemas
5Proyecto de dominio (tu especialidad)Señal de profundidad para tu rol objetivo
6Comodín — personal o creativoMuestra personalidad y curiosidad genuina

Reglas para Fijar

SÍ fijar:
  - Proyectos con demos en vivo o enlaces de despliegue
  - Repos con READMEs completos y capturas de pantalla
  - Trabajo que coincida con los roles a los que postulas
  - Tu trabajo más reciente y más pulido

NO fijar:
  - Repos forkeados que no modificaste significativamente
  - Tutoriales seguidos (aunque estén completos)
  - Repos sin README
  - Cualquier cosa que no puedas explicar en una entrevista

README como tu Discurso de Portafolio

Cada repositorio fijado necesita un README que venda el proyecto en 30 segundos. Un reclutador dedicará menos tiempo que eso antes de decidir si sigue leyendo.

Estructura de README para Repos de Portafolio

# Nombre del Proyecto
Descripción de una oración sobre qué hace y por qué importa.

## Demo
[Enlace a demo en vivo] | [Enlace a video explicativo]

Captura de pantalla o GIF mostrando la app en acción.

## El Problema
¿Qué problema resuelve? ¿Quién tiene este problema?

## Cómo Funciona
Resumen de la arquitectura. Decisiones técnicas clave.
Diagrama si el sistema tiene múltiples componentes.

## Stack Tecnológico
Lista de tecnologías — pero solo las significativas.
No pongas HTML/CSS. Sí incluye tus integraciones de IA, bases de datos, destinos de despliegue.

## Características Clave
- Característica 1 — por qué es interesante técnicamente
- Característica 2 — qué fue difícil al construirla
- Característica 3 — qué mejorarías después

## Primeros Pasos
Instrucciones claras de configuración. Alguien debería poder ejecutar esto en menos de 5 minutos.

## Lo que Aprendí
Breve reflexión sobre el desafío técnico más difícil y cómo lo resolviste.

Anti-Patrones de README

Mal READMEMejor README
"Una app de React""Resumidor de reuniones con IA que convierte grabaciones en acciones"
Sin capturas de pantallaCaptura principal o GIF arriba del pliegue
Configuración: "clonar y ejecutar"Configuración: paso a paso con requisitos previos listados
Sin explicación de arquitecturaDiagrama del sistema mostrando cómo se conectan los componentes
Lista cada paquete npmDestaca las 3-4 tecnologías que importan

Demos en Vivo y Enlaces de Despliegue

El código es una hipótesis. Una app desplegada es una prueba.

Por Qué el Despliegue Importa

El reclutador ve un repo sin demo:
  "Código interesante... ¿funciona realmente?"

El reclutador ve un repo con enlace en vivo:
  "Déjame probarlo." → 2 minutos después → "Esta persona entrega."

Opciones de Despliegue por Tipo de Proyecto

Tipo de ProyectoDespliegue GratuitoBueno Para
App web full-stackVercel, Railway, Fly.ioApps con sensación de producción
API / backendRailway, RenderMostrar habilidades de backend
Sitio estático / docsGitHub Pages, NetlifyDocumentación, landing pages
Demo de IA/MLHugging Face Spaces, Streamlit CloudDemos de modelos, apps de datos
Herramienta CLInpm publish, Homebrew tapSeñal de distribución

Si No Puedes Desplegar, Graba una Demo

No todo se puede ejecutar en la nube. Para herramientas solo locales, apps CLI o sistemas complejos:

1. Graba un video explicativo de 60 a 90 segundos.
2. Súbelo a YouTube (no listado está bien).
3. Crea un GIF de la interacción clave.
4. Pon ambos en el README.

Una demo en video es diez veces mejor que ninguna demo.


Gráfico de Contribuciones

Qué Señala la Consistencia

Los reclutadores echan un vistazo a tu gráfico de contribuciones. Esto es lo que realmente interpretan:

PatrónInterpretación
Verde constante, la mayoría de los días"Esta persona programa regularmente. Buen hábito."
Agrupado alrededor de proyectos"Trabaja en sprints enfocados. Normal."
Verde solo entre semana"Tiene trabajo, pero aún así publica trabajo personal."
Mezcla de repos propios y contribuciones"Colaborativo. No solo proyectos en solitario."

Cómo se Ve el Falseo

Los revisores experimentados detectan esto al instante:

SEÑALES DE ALERTA:
  - Verde perfectamente uniforme (todos los días, misma intensidad)
  - Commits que son solo ediciones de README o cambios de espacios en blanco
  - 500 commits en un día a repos vacíos
  - Docenas de repos creados en una semana, todos con un solo commit
  - Bots de commits generados automáticamente

Falsear tu gráfico es peor que tener lagunas. Señala desesperación y mal juicio. La consistencia real significa trabajar en cosas que te importan con una cadencia regular — lagunas incluidas.

Construir un Gráfico Real

En lugar de fingir:
  1. Elige un proyecto y trabaja en él 30 minutos al día.
  2. Contribuye a open source — incluso docs, tests o reportes de bugs cuentan.
  3. Mantén un repo de aprendizaje donde subas notas y experimentos.
  4. Construye herramientas que realmente uses. Mejorarás naturalmente.

Alinear tu Portafolio con el Rol que Deseas

Tu portafolio debe verse como una vista previa del trabajo que harías si te contrataran. Adáptalo a tu objetivo.

Roles de Desarrollo Nativo en IA

Estos roles quieren ver que puedes construir con IA y construir para IA:

SeñalRepo de Ejemplo
Uso de herramientas de IA en tu flujo de trabajoProyecto con configuración .claude/, commits asistidos por IA, comandos slash de Claude Code
Flujos de trabajo agénticosAgente de múltiples pasos que investiga, planifica y ejecuta tareas
Integraciones de LLMApp con salida estructurada, ingeniería de prompts, enrutamiento de modelos
RAG y recuperaciónBase de conocimiento con búsqueda por embeddings y métricas de evaluación
Evaluación y pruebasMarco de evaluación de salidas de LLM, pruebas de regresión de prompts
Desarrollo asistido por IAREADME del proyecto documentando cómo las herramientas de IA aceleraron el desarrollo

Objetivos de Portafolio por Rol

Rol ObjetivoRepos ImprescindiblesBuenos Tener
Ingeniero de IA/MLModelo ajustado, marco de evaluación, pipeline de datosImplementación de paper, comparación de modelos
Desarrollador Full-Stack de IAApp integrada con LLM, sistema RAG, SaaS desplegadoContribución open-source, herramienta CLI
Ingeniero de Plataforma/InfraPipeline CI/CD, repo de IaC, configuración de monitoreoBenchmark de rendimiento, contribución OSS
Herramientas de Desarrollo/DXHerramienta CLI, SDK/librería, extensión de VS CodeSitio de documentación, herramienta de comunidad de desarrolladores

Lista de Verificación de Revisión de Portafolio

Realiza esta auditoría antes de cada búsqueda de empleo. Sé honesto.

Primera Impresión (30 segundos)

  • La foto de perfil es profesional (o intencionalmente distintiva)
  • La biografía indica qué haces y qué buscas
  • Los repos fijados tienen descripciones que un extraño entiende
  • Al menos 3 repos fijados tienen capturas de pantalla o enlaces de demo en el README
  • No hay nombres de repos embarazosos visibles en la primera página

Verificación de Profundidad (2 minutos)

  • Cada repo fijado tiene un README que explica el qué, por qué y cómo
  • Al menos un proyecto tiene una demo en vivo o enlace de despliegue
  • La calidad del código en los repos fijados refleja tu nivel de habilidad actual
  • El historial de commits muestra desarrollo real (no un solo "commit inicial" masivo)
  • Al menos un repo demuestra pruebas o CI/CD

Verificación de Historia (5 minutos)

  • Tus repos fijados cuentan una historia coherente sobre tus habilidades
  • Hay una progresión visible de proyectos antiguos a nuevos
  • Tu portafolio está alineado con los roles que estás buscando
  • Puedes explicar cada repo fijado en un elevator pitch de 60 segundos
  • Te contratarías a ti mismo basándote en este GitHub

La Prueba Definitiva

Abre tu GitHub en una ventana de incógnito. Pretende que eres un reclutador que nunca te ha conocido. Dedica 60 segundos. ¿Pasarías a este candidato a la siguiente ronda?

Si la respuesta no es un sí inmediato, sigue iterando.


Anti-Patrones

Anti-PatrónPor Qué DueleSolución
Repos forkeados sin cambiosParece rellenoElimina o hazlos privados
Clones de tutoriales ("todo-app", "weather-app")Señala que seguiste instrucciones, no que sabes construirFórcale un fork y extiéndelo mucho más allá del tutorial
Repos vacíos o con solo un READMESeñala ideas abandonadasArchívalos o elimínalos
Sin READMEs en repos públicos"No comunico sobre mi trabajo"Agrega READMEs a todo lo que mantengas público
50+ repos visibles sin curaduríaRuido abrumador, sin señalArchiva agresivamente, fija estratégicamente
Repos fijados desactualizados (2+ años)"No han construido nada recientemente"Rota los fijados para mostrar trabajo reciente
README de perfil solo con estadísticas auto-generadasImpersonal, poco esfuerzoEscribe una biografía real con tu enfoque y objetivos
Repos llamados "test", "temp", "asdf"DescuidadoRenómbralos o elimínalos

Jugada Maestra

"Revisa mi portafolio de GitHub en [tu URL de GitHub]. Evalúalo como si fueras un reclutador para un rol de desarrollo nativo en IA. Puntúa cada repo fijado en calidad del README, profundidad técnica, estado de despliegue y relevancia para roles de IA/ML. Luego dame un plan de acción priorizado: qué archivar, qué mejorar, qué falta y qué nuevo proyecto marcaría la mayor diferencia."

El agente se convierte en tu crítico de portafolio, dándote la retroalimentación honesta y específica que necesitas para convertir tu GitHub de un cementerio de código en un activo profesional.

Habilidades Relacionadas

HabilidadCuándo Usarla
github-profileImplementar mecánicas de la plataforma GitHub — README de perfil, fijado de repos, temas, gráfico de actividad
career-resumeCiclo de vida profesional completo — búsqueda de empleo, entrevistas, onboarding, revisiones de desempeño

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

diegosouzapw/awesome-omni-skill

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

diegosouzapw/awesome-omni-skill

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

diegosouzapw/awesome-omni-skill

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

diegosouzapw/awesome-omni-skill

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

diegosouzapw/awesome-omni-skill

Optimize project portfolio selection under constraints using mathematical optimization

diegosouzapw/awesome-omni-skill

Rapidly build, prototype, and deploy full-stack software using AI "text-to-app" tools. Use this when you need to create a greenfield application, build a high-fidelity working prototype for user testing, or bypass traditional engineering bottlenecks for internal tools.

diegosouzapw/awesome-omni-skill

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

diegosouzapw/awesome-omni-skill

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

diegosouzapw/awesome-omni-skill

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

diegosouzapw/awesome-omni-skill

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

diegosouzapw/awesome-omni-skill

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

diegosouzapw/service-website-generator

Orchestrates automated service-based website generation with local SEO optimization. Creates 200+ service+location pages using parallel agents, Unsplash images via Jina AI, NextJS with dynamic routing, and PostgreSQL database. Use when building service business websites (plumbers, electricians, pressure washing, HVAC, etc.) targeting multiple locations.

Skills relacionados