Communitygithub.com

Personal Site Builder — del CV a tu web personal

Convierte un CV, perfiles sociales, portafolio y producción dispersa en una web personal estática lista para desplegar: entrevista y verifica evidencias, define la jerarquía por objetivo × profundidad, elige uno de 6 estilos visuales (o lo extrae de un sitio de referencia), genera, revisa en navegador y despliega solo con permiso.

¿Qué es Personal Site Builder — del CV a tu web personal?

Personal Website, paso 1 (componer): spacezephyr-personal-site-builder. Contenido → estructura → visual → código, sin inventar datos y con privacidad por defecto; entrega HTML/CSS/JS puro para Cloudflare Pages, Vercel o GitHub Pages. Después: página Sobre mí y hub link-in-bio.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add SpaceZephyr/personal-site-builder

Preguntar en tu IA favorita

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

Documentación

Generador de Sitios Web Personales

Convierte «un currículum + un montón de enlaces + trabajos dispersos» en un sitio web estático con estructura de información, estilo visual y listo para desplegar.

Resultado: un conjunto de HTML/CSS/JS puramente estático (sin compilación, sin framework, CSS en un solo archivo), desplegable directamente en Cloudflare Pages / Vercel / GitHub Pages.

Principios Fundamentales

  • El orden no se puede invertir: primero contenido → luego estructura → luego visual → finalmente código. No empieces con plantillas ni preguntes por colores o fuentes.
  • Distinguir cuatro tipos de información: hechos confirmados por el usuario / resúmenes textuales de fuentes / borradores redactados por IA / inferencias pendientes de confirmar. No inventes experiencias, números, clientes, reseñas, identidades o relaciones.
  • Proteger la privacidad por defecto: antes de hacer públicos números de teléfono, direcciones, correos electrónicos privados o materiales de clientes, debes obtener confirmación explícita.
  • No crear secciones vacías para llenar la plantilla: si falta información, reduce la profundidad del contenido o enumera lo que falta; no uses casos de relleno.
  • Ofrecer opciones con recomendación: en cada punto de decisión, da 2–3 opciones con diferencias sustanciales + una recomendación clara; no delegues toda la elección al usuario.
  • Desplegar es un acto de publicación externa: solo se ejecuta con autorización explícita del usuario.

Flujo de Trabajo

① Definir alcance → ② Recopilar materiales → ③ Definir jerarquía de información → ④ Definir estilo visual → ⑤ Generar → ⑥ Validar → ⑦ Desplegar tras autorización

① Definir alcance

Primero determina si es nuevo o reformar un sitio existente.

  • Si hay proyecto: lee primero la estructura de directorios, páginas existentes, fuentes de contenido, comandos de compilación, configuración de despliegue y estado de git. Mantén la tecnología y restricciones de diseño existentes, no empieces desde cero.
  • Si es nuevo: por defecto, sitio estático ligero y responsivo; solo introduce framework o backend si realmente se necesita CMS, inicio de sesión o datos dinámicos.

Luego, haz una sola pregunta para definir la dirección:

«¿Para quién es principalmente este sitio? ¿Qué quieres que haga después de verlo?»

No preguntes por colores, fuentes o animaciones en este paso.

② Recopilar materiales

Lee references/intake.md (contiene: materiales mínimos de inicio, orden progresivo de preguntas, campos de entidades de contenido, niveles de evidencia, reglas de privacidad, tabla de fuentes extraíbles).

Puntos clave:

  • La respuesta inicial debe ser ligera. El usuario ya ha dicho lo que tiene; en la primera respuesta, solo pídele que envíe eso. Después de leer el primer lote, pasa a la siguiente pregunta. Haz solo una pregunta que impacte el siguiente paso cada vez, no lances una docena de campos de formulario.
  • Lee lo que se pueda leer primero, no preguntes. Currículum (Read / docx / pdf skill), GitHub, blog, artículos de WeChat (WebFetch), plataformas que requieren inicio de sesión (claude-in-chrome). Si encuentras muro de inicio de sesión, captcha o antiscraping, detente inmediatamente y pide al usuario que proporcione archivos exportados, texto, lista de enlaces o capturas de pantalla.
  • Los números importan más que los adjetivos, y solo usa métricas verificables. «10 productos, 50,000 usuarios, casi 200 habilidades» es mejor que «experiencia amplia»; no completes con estimaciones si no se puede verificar.
  • Contenido duplicado entre plataformas se fusiona en una entidad de contenido, manteniendo múltiples enlaces de origen; si hay conflictos de información, conserva ambas versiones y pide al usuario que confirme.

Al finalizar, genera un listado de confirmación de materiales (existente / pendiente de confirmar / faltante / sugerencia de completar). Cuando el usuario confirme, pasa al siguiente paso.

③ Definir jerarquía de información

Lee references/architectures.md. Usa un doble eje para la decisión:

Eje 1 · Objetivo del sitio (elige un objetivo principal, como máximo un secundario)

El perfil del usuario es principalmenteObjetivo principal
Experiencia laboral, habilidades, educación, para enviar currículumConversión de búsqueda de empleo
Proyectos / diseño / fotografía / vídeo, mucho material visualPortafolio de trabajos
Una historia de vida + intereses + valores, pocos trabajos concretosPresentación personal
Artículos escritos / libros leídos / caminos recorridos, para archivarRegistro a largo plazo
Quiere recibir consultoría, encargos, tutorías, negociosCaptación de clientes por consultoría
Cuenta en WeChat / X / Xiaohongshu / podcast, con seguidores y contenidoPágina de creador
Ha lanzado productos, proyectos de código abierto, quiere que la gente los use/compreDesarrollador independiente

Eje 2 · Profundidad del contenido (determinada por la cantidad de materiales, no por el deseo)

  • L1 Nivel tarjeta de presentación — Una sola página, solo con identidad / posicionamiento / acción principal / 3 enlaces representativos. Materiales escasos o necesidad de lanzamiento rápido.
  • L2 Nivel de evidencia — Página principal + páginas de detalle de proyectos/experiencia. Requiere contribuciones personales, proceso, resultados, material multimedia.
  • L3 Nivel de sistema de contenidos — Página principal + detalle + índice de categorías + archivo + mecanismo de actualización continua. Requiere fuente de contenido estable y voluntad de actualizar.

Si los materiales no alcanzan L2, ve primero a L1; si no hay capacidad de actualización continua, no elijas L3.

Siguiendo la plantilla de architectures.md, genera 2–3 opciones con diferencias reales (las diferencias deben basarse en las tareas del visitante, no solo en renombrar secciones). Para cada opción, indica: para quién es adecuada / promesa de la primera pantalla / acción principal / navegación / orden de la página principal / qué materiales existentes utiliza / qué más se necesita / principales compensaciones. Recomienda claramente una opción. Cuando el usuario confirme, pasa al siguiente paso.

④ Definir estilo visual

Primero pregunta: «¿Tienes algún sitio o diseño que te guste? Si es así, envíame el enlace o una captura de pantalla.» Tener una referencia es mucho más preciso que pedir al usuario que elija entre adjetivos.

Tres caminos, según lo que tenga el usuario:

  1. El usuario proporciona URL de referencia / captura de pantalla / guía de estilo → lee references/style-extraction.md. Primero intenta abrir el sitio de referencia con claude-in-chrome, ejecuta el script que viene para muestrear los estilos computados reales (pila de fuentes, valores de color, bordes redondeados, sombras, ancho del contenedor), muestrea tanto para modo claro como oscuro; si no se puede abrir o requiere inicio de sesión, recurre al análisis de captura de pantalla. Extrae la esencia, no clones el sitio entero, no tomes el logotipo, textos, ilustraciones ni diseños originales.
  2. El usuario menciona una marca («Que se sienta como Notion», «estilo Apple») → invoca el skill brand-design-md para obtener DESIGN.md, y mapea las variables :root en site.css.
  3. El usuario no tiene referencia → lee references/visual-styles.md, de 6 estilos incorporados propón 2–3 direcciones con razón de recomendación, cada una con valores de variables CSS que se puedan pegar directamente.

Si el usuario da múltiples sitios de referencia, primero pregúntale: «¿Cuál quieres que se sienta más? ¿Qué te gusta específicamente de los otros?» — la mayoría prefiere la maquetación de A + la paleta de colores de B; hacer la intersección directa produce un híbrido sin personalidad.

Cuando el usuario mencione WordPress / Framer / Webflow / Notion, toma prestada su organización de información y esencia, no pretendas generar un tema o proyecto para la plataforma correspondiente.

Independientemente del camino, al final solo modifica las variables :root, no reescribas las partes de componentes de site.css. Una vez seleccionado, escribe el código.

⑤ Generar el sitio

Comienza copiando assets/starter/:

  • site.css — Variables CSS + línea base de tipografía + componentes de tarjetas/listas, tema claro/oscuro. Cambiar estilo = cambiar variables :root, no reescribir todo el archivo.
  • nav.js — Barra superior fija inyectada en un solo archivo (cambio de tema oscuro + ocultación al hacer scroll). En la zona de configuración superior cambia SITE_NAME / LINKS / THEME_KEY. El 760px en su CSS en línea debe coincidir con --max de site.css.
  • index.html — Esqueleto de la página principal, secciones se añaden/eliminan según el plan.

Debe cumplir:

  • En la primera pantalla aparece nombre real o apodo + posicionamiento + una acción principal; solo una acción principal, como máximo una secundaria.
  • La navegación refleja la arquitectura de información confirmada, no copia las secciones de la plataforma; entre 4 y 6 elementos.
  • Los trabajos priorizan problema / mi rol / enfoque / resultado, no solo miniaturas.
  • Los enlaces sociales explican qué se puede ver en esta plataforma, no solo una fila de iconos.
  • Cada página tiene xxx/index.html independiente, comparte /site.css y /nav.js; no uses CDN, frameworks ni pasos de compilación.
  • <title>, <meta name="description">, favicon e imagen para compartir completos; enlaces externos con target="_blank" rel="noreferrer".
  • Navegación fluida en escritorio y móvil; flujo principal accesible por teclado; estructura semántica y alt completos; soporte para prefers-reduced-motion.
  • Las imágenes deben ser trabajos reales / personas / capturas de pantalla; si faltan, pide material; las imágenes generadas deben indicarse como material generado.
  • No uses frases como «Este es mi sitio web personal» o «A continuación, mis trabajos» como parte del diseño.

Tipografía en chino: altura de línea ≥ 1.7, espacio entre párrafos ≥ 18px, la pila de fuentes debe incluir PingFang SC. Si se necesita mayor capacidad de diseño frontend, invoca el skill frontend-design.

⑥ Validación

Lee references/delivery-checklist.md y revisa cada punto. Verifica al menos:

  • Página principal, navegación, páginas de detalle, enlaces externos, acción principal
  • En anchos: 360 / 390 / 768 / 1280 / 1440
  • Nombres y títulos largos no se desbordan; comportamiento con contenido vacío, error de carga de imagen, enlace roto
  • Consola sin errores que afecten el uso; sin desplazamiento horizontal inesperado ni superposición de diseño
  • Tanto tema claro como oscuro son legibles (contraste ≥ 4.5:1)
  • No hay restos de TODO, números ficticios ni enlaces de prueba en el sitio
  • La información pública coincide con la lista confirmada por el usuario

Usa python3 -m http.server para vista previa local, o capturas de pantalla con claude-in-chrome, para que el usuario confirme antes de publicar.

⑦ Desplegar tras autorización

Explica primero dónde se publicará, si es público, qué repositorio/cuenta se usará, qué dominios o variables de entorno se modificarán. Obtén autorización explícita antes de ejecutar.

  • Si hay proyecto existente, mantén el método de despliegue actual; para sitios estáticos nuevos, prioriza Cloudflare Pages / Vercel / GitHub Pages (deja el comando de compilación vacío, establece el directorio de salida como raíz del sitio).
  • Primero compila → luego publica → luego accede a la URL de producción para verificar el contenido crítico. Vista previa exitosa no significa que el dominio personalizado funcione.
  • No empaques claves, originales de currículum ni datos exportados de plataformas en el sitio.

Instrucciones de Entrega Final

Enumera de forma concisa: objetivo seleccionado y profundidad del contenido / páginas implementadas y contenido clave / URL de acceso / resultados de validación / contenido aún no público o pendiente de completar. No uses largas repeticiones para ocultar código, validación o despliegue incompletos.

Lista de Prohibiciones

  • ❌ Llenar la página principal con todo el contenido — la primera pantalla debe decir en 3 segundos «quién eres + qué sabes hacer + cómo contactarte»; todo lo demás se degrada
  • ❌ Frases vacías como «Apasionado de la tecnología, en busca de la excelencia» — sustitúyelas por hechos y números verificables
  • ❌ Inventar experiencias, proyectos, números o reseñas de clientes que el usuario no ha proporcionado
  • ❌ Lanzar una docena de preguntas a la vez; o saltarse la confirmación de materiales y la confirmación del plan para ir directamente a escribir código
  • ❌ Forzar L3 con materiales insuficientes, usando blogs vacíos y casos de relleno para aparentar
  • ❌ Animaciones complejas, degradados excesivos, una fuente diferente para cada sección — la credibilidad de un sitio personal viene de la moderación
  • ❌ Copiar el sitio de referencia entero y cambiarle el nombre — lo que se extrae es la esencia de colores/maquetación/espaciado, no el logotipo, textos, ilustraciones ni diseños originales
  • ❌ Hacer push / desplegar / hacer públicos datos de contacto sin autorización

Skills relacionados