Communitygithub.com

Generador de Portafolio Hope

Genera un portafolio profesional completo y autónomo (carpeta offline) que los usuarios pueden enviar a reclutadores, publicar como enlace o guardar como PDF. Esta es la habilidad distintiva de Hope.

¿Qué es Generador de Portafolio Hope?

Este skill implementa la generación del portafolio 'Hope Portfolio' para asistentes de IA como Claude Code. Crea una carpeta de portafolio autónoma, offline y totalmente funcional, compuesta por cuatro archivos (index.html, portfolio.css, portfolio.js, data.js) más dos tarjetas para compartir. El asistente lee la gráfica de carrera del usuario (archivos de experiencia, educación, proyectos, habilidades, etc.) y los tokens de diseño y guía de voz desde el plugin de Hope, luego genera un conjunto de datos estructurados (`window.HOPE_DATA`) que el motor de renderizado runtime (portfolio.js) convierte en una página web interactiva y visualmente distintiva. El resultado incluye: tarjetas de identidad, línea de tiempo animada, sección de resumen, experiencia seleccionada, proyectos, habilidades con chips expandibles, educación/certificaciones con tarjetas enriquecidas, vista oculta de currículum PDF, controles de exportación y selector de temas claro/oscuro. Sigue reglas estrictas de voz (nunca inventa hechos), usa fichas técnicas de diseño y optimiza el SEO con metadatos Open Graph y JSON-LD. El asistente debe seleccionar contenido según un puesto objetivo (si se especifica) o mostrar el mejor trabajo general, y registrar las decisiones en un nodo CuratedPortfolio.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

Preguntar en tu IA favorita

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

Documentación

Portafolio Hope · Hito 3 — La firma de Hope

Estás ejecutando la generación de portafolio de Hope. Esta es la habilidad que define a Hope. El usuario presenta este artefacto y empieza a recibir llamadas para entrevistas. Haz que cuente.

Localiza primero los archivos del plugin (haz esto antes que cualquier otra cosa)

Los documentos de referencia de Hope y la carpeta de plantilla del portafolio están dentro del plugin, no en el proyecto del usuario. Las rutas a continuación (references/…, assets/templates/…) son relativas a la raíz del plugin — NO son relativas a tu directorio de trabajo (que es la carpeta del proyecto del usuario). ${CLAUDE_PLUGIN_ROOT} no se sustituye dentro de este Markdown, por lo tanto debes resolver la raíz del plugin tú mismo con Bash, una vez, antes de leer cualquier archivo:

# Resuelve la raíz del plugin de Hope (references/, assets/, scripts/ están ahí).
# $CLAUDE_PLUGIN_ROOT NO se expande en este Markdown — resuélvelo en Bash.
# Funciona si Hope está instalado, en caché del marketplace, o ejecutado con --plugin-dir.
ROOT_PLUGIN=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
  [ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { ROOT_PLUGIN="${c%/}"; break; }
done
[ -z "$ROOT_PLUGIN" ] && ROOT_PLUGIN="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "ROOT_PLUGIN=$ROOT_PLUGIN"   # verifica la cordura antes de leer los archivos incluidos

Si ROOT_PLUGIN queda vacío, pregúntale al usuario dónde está extraído el plugin de Hope (por ejemplo, una ruta --plugin-dir) en lugar de adivinar rutas relativas — una lectura relativa de references/… se resuelve contra la carpeta del proyecto del usuario y dará un error 404.

Lee estos archivos antes de generar — son de carga crítica. Las fichas técnicas de diseño son inamovibles; las reglas de voz se aplican a cada palabra del portafolio:

cat "$ROOT_PLUGIN/references/design-tokens.md"
cat "$ROOT_PLUGIN/references/voice-guide.md"
cat "$ROOT_PLUGIN/references/career-graph-schema.md"
cat "$ROOT_PLUGIN/references/milestones.md"

Qué produce esta habilidad

Una carpeta de portafolio en career-graph/documents/portfolios/portfolio-<slug>-<date>/ que contiene exactamente cuatro archivos nombrados:

  • index.html — un shell estático con SEO: el <head> (título/descripción/OG/Twitter/JSON-LD enriquecido/canonical/hope:share-url), el inline theme-init, un bloque estático .seo-fallback en el body (nombre/titular/resumen, eliminado al hidratarse), la barra superior estática + modal de exportación, y puntos de montaje vacíos. No hay marcado de contenido aquí — el body visible se renderiza en tiempo de ejecución mediante portfolio.js a partir de window.HOPE_DATA. Este es el archivo donde se estampan los valores SEO del head y el meta hope:share-url.
  • portfolio.css — la hoja de estilo completa; las fichas técnicas de diseño (:root) viven aquí y en ningún otro lugar (incluyendo los 15 tokens de nivel de segmento / categoría / integridad — consulta el canon de design-tokens).
  • portfolio.js — el script de comportamiento completo y el motor de renderizado en tiempo de ejecución — construye todo el <body> visible a partir de window.HOPE_DATA.
  • data.js — un script clásico que define un único global: window.HOPE_DATA = {…}: el conjunto de datos completo para toda la página (meta + mapa de confianza, identidad, resumen, experiencia, proyectos, habilidades, educación, certificaciones, currículum, línea de tiempo, traveler, social), en valores semánticos únicamente — SIN hexadecimal, con la foto incrustada como una URL data:. El data.js de la plantilla lleva el contrato de autoría campo por campo (el esquema de window.HOPE_DATA) — léelo antes de emitir, y trátalo como la fuente de verdad para los tipos de campo y su opcionalidad.

— más dos páginas de tarjeta para compartir (share-card.html y share-card-square.html) en la misma carpeta — consulta "Tarjetas para compartir y metadatos de vista previa de enlaces" a continuación.

La promesa de autonomía es a nivel de carpeta: la carpeta no necesita nada más que un navegador — completamente funcional sin conexión. (Apertura: consulta el paso "mostrarlo" — en macOS, un servidor local de una línea es la ruta confiable; el doble clic suele funcionar, pero puede estar bloqueado por los permisos de la carpeta.) Es ley — solo <script src> y <link rel="stylesheet"> clásicos; nada de type="module", ni fetch(), ni import. Sin <style>/<script> inline en index.html excepto el fragmento theme-init (inline en <head> por diseño — evita el destello del tema) y el JSON-LD. Lo que pertenece a cada archivo es canon — design-tokens.md § "Estructura modular" (cargado arriba); cítalo, no lo reformules. La página usa las fichas de diseño de Hope — tema claro por defecto (crema cálida + naranja), con un tema oscuro a través del alternador y el mismo diseño en ambos — genera SVG inline para cualquier gráfico, y se abre en cualquier navegador sin necesidad de conexión de red.

Qué contiene:

  • Tarjeta de identidad — foto, nombre, titular, fila de estadísticas, fila de contacto y resumen, sobre una textura de cuadrícula de 32×32, con la píldora EN VIVO en la parte superior derecha.
  • El Hilo Conductor (The Throughline) — la tira animada de línea de tiempo profesional en la parte inferior de la tarjeta de identidad (id="throughline"): un nodo hexagonal por cada experiencia/educación/proyecto/certificación incluidos, un cabezal de reproducción que recorre el carril, mini-tarjetas al pasar el ratón, clic para navegar a la tarjeta de cada entrada. El aspecto y la animación de la tira son propiedad de la plantilla; tu trabajo es el conjunto de datos y los anclajes de las tarjetas — consulta "El Hilo Conductor — contrato de datos de la línea de tiempo" a continuación.
  • Aplicación de resumen (optativa) — una pestaña de cuadrícula de sección, no una banda independiente: un mosaico de cuadrícula (data-section="overview", etiquetado "Resumen", icono insights, meta contador "{n} destacados") más un panel (id="pane-overview") que se sitúa primero entre los paneles y se abre por defecto cuando está presente. Dentro: hasta 4 estadísticas destacadas seleccionadas como grandes insignias hexagonales más una línea de intereses. Se renderiza solo cuando overview.show es verdadero y overview.headline_stats no está vacío — consulta "Aplicación de resumen — mapeo de campos" a continuación.
  • Resumen — 2–4 frases con la voz de Hope. Específico, no genérico. Insinúa tensión antes de la resolución.
  • Experiencia seleccionada — de 3 a 5 experiencias más relevantes como tarjetas, cada una con: título, empresa, fechas, una frase de encuadre, la contribución más sólida (STAR con una métrica) y las habilidades demostradas.
  • Proyectos seleccionados — misma forma que la experiencia, para proyectos dignos de portafolio fuera del empleo formal.
  • Sección de habilidades — habilidades principales (organizadas por categoría, liderando con las más demandadas en el mercado que tengan la evidencia más sólida). Cada chip de habilidad se puede hacer clic para expandir qué experiencias/proyectos le dieron evidencia.
  • Educación / Certificaciones — breve, factual. Cuando una entrada lleva honores o un logro que merece mostrarse que vive en el archivo profesional (una beca, premio, distinción, tesis notable), renderízala como una tarjeta enriquecida — consulta "Tarjetas enriquecidas de educación y certificaciones" a continuación. De lo contrario, una tarjeta .edu-card básica. Nunca inventes honores; renderiza solo lo que está.
  • Contacto — correo electrónico y LinkedIn, nada más. Opcional.
  • Alternador de tema — botón sol/luna en la parte superior derecha; cambia claro/oscuro, el diseño no cambia.
  • Vista oculta de currículum — #resume-view, invisible en pantalla, renderizada en tiempo de ejecución a partir de resume para la ruta de impresión de currículum (consulta "Vista de currículum — mapeo de campos" a continuación).
  • Controles de exportación y para compartir — el botón Guardar como PDF de la plantilla exporta el currículum: un selector (#export-modal) de estilo + fuente + ajuste, con un piso de legibilidad estricto — el texto del cuerpo nunca baja de 10pt. El selector de PDF del portafolio está restringido para la próxima versión — la página en vivo ES el portafolio, y Cmd+P todavía lo imprime de forma nativa. Compartir abre un menú de Copiar enlace / LinkedIn / X / WhatsApp / Correo electrónico (#share-menu). Estos se envían en la plantilla; tu trabajo es el contenido del que dependen (vista de currículum, metadatos OG, tarjetas para compartir).

Cómo elegir qué incluir

Lee la gráfica profesional del usuario. Si se nombra un Trabajo objetivo (hope make portfolio for Anthropic), encuentra el nodo JobPosting y:

  1. Calcula qué Habilidades el Trabajo REQUIRES_SKILL y cuáles la Persona HAS_SKILL.
  2. Elige las Experiencias/Proyectos cuyas aristas USED_SKILL y APPLIED_SKILL se intersequen más fuertemente con las habilidades requeridas del Trabajo.
  3. Ordena: más relevante primero, más reciente segundo, con más métricas tercero.
  4. Apunta a densidad, no exhaustividad. Tres tarjetas sobresalientes son mejores que siete tarjetas pasables.

Si no se nombra un Trabajo objetivo, genera un portafolio general que represente el mejor trabajo general del usuario.

De cualquier manera, crea un nodo CuratedPortfolio en la gráfica que enlace a las Experiencias/Habilidades/Proyectos incluidos, y registra en él las decisiones del usuario sobre el catálogo de aplicaciones como "show_summary": true|false y "show_social": true|false, y su elección de traveler como "timeline_traveler" (consulta el catálogo de aplicaciones y el selector de traveler a continuación — elecciones de presentación por portafolio, no hechos de la Persona). Esto significa que la gráfica del usuario recuerda qué curación salió para qué rol.

Voz en el texto del portafolio

Hope nunca inventa un hecho sobre el usuario. Cada línea que escribes — un punto, una calificación, un plan, una afirmación — debe remontarse al archivo profesional o a las propias palabras del usuario en este chat; una afirmación que no puedas rastrear es una afirmación que no haces. Esta es una promesa declarada en el sitio de Hope, y cada habilidad la cumple.

No estás escribiendo un currículum. Estás escribiendo una declaración de trabajo diseñada con la voz de Hope.

Cada tarjeta de Experiencia debe:

  • Abrir con un momento o problema específico, no un resumen del puesto
  • Mostrar qué cambió debido a la acción del usuario (con una métrica)
  • Evitar el lenguaje de "responsable de" — muestra, no digas
  • Tener de 60 a 120 palabras por tarjeta, como máximo

Ejemplo de transformación:

❌ "Diseñador Senior de Producto en Figma. Responsable del sistema de diseño, mentoría de diseñadores junior, liderazgo de iniciativas multifuncionales."

✅ "Cuando el sistema de diseño de Figma comenzó a fragmentarse entre los equipos de producto en 2023, lideré la consolidación. Ocho meses después, el 37% de la superficie de la empresa estaba unificada en el nuevo sistema, y el tiempo de incorporación de nuevos diseñadores pasó de tres semanas a una. La parte difícil no fueron los componentes — fue lograr que doce equipos de producto se pusieran de acuerdo en un solo botón."

El usuario puede editar, pero el primer borrador debe parecer que lo escribió Hope.

Nivel de calidad visual

Este es el diferenciador visible. El portafolio se ve inconfundiblemente como un artefacto de Hope — el diseño y la textura son la marca, el color es el tema:

  • Tema claro por defecto (crema cálida + naranja). Oscuro a través del alternador, mismo diseño.
  • Cuadrícula de sección interactiva — haz clic en una sección para filtrar el contenido debajo; la pestaña activa es naranja sólido con un resplandor y una barra de integridad.
  • Insignias hexagonales de KPI (persona / grupos / monitoreo) en cada rol.
  • Tarjetas de contribución agrupadas por IC vs Liderazgo; habilidades agrupadas por categoría con un indicador visual de nivel de 4 barras; los proyectos se renderizan como el mismo .item-card expandible tipo Experiencia (consulta el contrato de bucle de proyectos a continuación) para que la historia completa de cada proyecto se muestre.
  • Píldora EN VIVO dentro de la fila de identidad, arriba a la derecha.
  • Superposición de líneas de barrido en las tarjetas + textura de cuadrícula de 32×32 en el encabezado de identidad + sutiles resplandores. Estas texturas son firmas — sin ellas el diseño parece genérico.
  • Inter para texto, JetBrains Mono para todos los metadatos. Material Symbols Rounded con fallback SVG inline.
  • Logotipos reales de organizaciones a través de Google Favicon con un fallback de marca de letra.
  • Autónomo a nivel de carpeta (consulta "Qué produce esta habilidad"). Sin llamadas de red obligatorias excepto Google Fonts opcional (que degrada a fuentes del sistema cuando está bloqueado).

Usa la plantilla incluida como estructura inicial — es una carpeta que refleja la carpeta de salida (los mismos cuatro archivos nombrados). Cárgala desde la raíz del plugin que resolviste arriba:

ls "$ROOT_PLUGIN/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$ROOT_PLUGIN/assets/templates/portfolio/index.html"  # el shell estático: cabeza con SEO, .seo-fallback, montajes vacíos
cat "$ROOT_PLUGIN/assets/templates/portfolio/data.js"     # lleva el contrato de autoría de window.HOPE_DATA

Contrato de construcción (impulsado por datos en tiempo de ejecución)

El portafolio no se construye sustituyendo tokens en un marcado estático. El agente emite un conjunto de datos estructurados y el portfolio.js incluido renderiza todo el <body> visible a partir de él en tiempo de ejecución. No hay tokens de contenido {{…}} ni marcadores <!-- HOPE:*_loop --> en la nueva plantilla — han sido reemplazados por window.HOPE_DATA. Sigue estos pasos en orden:

  1. Cura a partir de la gráfica (según "Cómo elegir qué incluir" a continuación): identidad, resumen, experiencia (agrupada por IC/Liderazgo, forma de progresión de roles), proyectos, habilidades (por categoría, nivel 1–4 + años), educación, certificaciones, currículum (puntos con una tag añadida; Education = solo títulos), línea de tiempo, social, y un mapa de confianza por sección.
  2. Emite data.js = window.HOPE_DATA = {…} — UN global, el conjunto de datos completo para toda la página (el contrato de autoría de data.js de la plantilla es el esquema de window.HOPE_DATA). Valores semánticos únicamente — SIN hexadecimal (category:"programming", level:4, confidence.band:"high" — portfolio.js los resuelve a var(--token) en el renderizado). La foto se incrusta como una URL data: en identity.photo.
  3. Copia portfolio.css y portfolio.js en la carpeta de salida textualmente. portfolio.css ya lleva los 15 tokens de nivel de segmento / categoría / integridad que el motor de renderizado resuelve; portfolio.js es el motor de renderizado en tiempo de ejecución. Ninguno se edita nunca por portafolio. No te desvíes de las fichas de diseño en $ROOT_PLUGIN/references/design-tokens.md (cargadas arriba).
  4. Estampa el shell index.html a partir de los mismos meta que pusiste en data.js, en una sola pasada — data.js es la única fuente de verdad y la cabeza/el cuerpo se estampan A PARTIR de él:
    • Cabeza: name/headline/og_description → <title> + description + og:*/twitter:*; share_url → hope:share-url + <link rel="canonical">; generation_date + el JSON-LD enriquecido de ProfilePage (description/url/image/sameAs); target_company → sufijo del título.
    • Cuerpo: el bloque estático .seo-fallback — name / headline / summary_short.
    • Deja og:url / og:image / twitter:image vacíos (content="") para que el skill de publicación los estampe. Sin {{…}} dejado en ningún lado.
  5. Genera ambas páginas de tarjeta para compartir (share-card.html y share-card-square.html) en la misma carpeta de salida, siguiendo la plantilla share-card-*.html del plugin y usando los metadatos de data.js.

Skills relacionados