Crear Sitio Personal
Objetivo
Crear o rediseñar un sitio web personal como archivos estáticos planos: HTML, CSS y JavaScript vanilla opcional.
Este skill es el paso de implementación después de haber elegido una dirección visual. Convierte una recomendación de tema, perfil de usuario, notas, publicaciones de muestra, descripciones de proyectos o una carpeta de sitio estático existente en un sitio personal funcional.
Promesa principal:
- Sin framework.
- Sin paso de construcción.
- Sin instalación de paquetes.
- Sin dependencias en tiempo de ejecución.
- Abre
index.htmldirectamente para vista previa manual. - Usa enlaces y activos relativos a la página para que la apertura directa de archivos, HTTP local y el hosting estático funcionen.
- Despliega la carpeta en un hosting estático.
Para QA automatizado en el navegador, sirve la carpeta estática a través de HTTP local en lugar de abrir URLs file://.
Contrato
Entradas:
- Dirección de tema, materiales del perfil de usuario, necesidades de página, contenido de muestra o una carpeta estática existente.
- Referencias opcionales que deben guiar el estilo sin requerir una réplica de alta fidelidad.
- Carpeta de salida deseada y restricciones estáticas.
Salidas:
- Una carpeta de sitio estático plano con HTML, CSS, JavaScript vanilla opcional, activos locales y tipos de página representativos.
EDITING.mdpara futuras ediciones cuando se cree un sitio nuevo o un rediseño material.- Instrucciones de vista previa local y resumen de validación.
Límites:
- No recrear fielmente un sitio web objetivo específico; usa
copy-website-style. - No importar grandes archivos de escritura; usa
add-blog-posts. - No publicar ni configurar hosting; usa
publish-static-site. - No introducir frameworks, instalaciones de paquetes, backend, CMS, autenticación o bases de datos a menos que el usuario lo solicite explícitamente.
Puerta de éxito:
- Existen los tipos de página requeridos y la navegación apunta a rutas relativas reales.
- El sitio funciona como archivos estáticos planos sin paso de construcción.
- El código fuente es legible en UTF-8, los marcadores de posición son claros y
review-static-sitepuede pasar o solo reportar limitaciones aceptadas.
Si la puerta falla:
- Corrige los tipos de página faltantes, rutas, activos, codificación, marcadores de posición o problemas del navegador dentro de este skill.
- Usa
personalize-sitecuando el fallo sea la falta de identidad/contenido del usuario. - Vuelve a usar
review-static-sitedespués de las correcciones.
Pipeline Corto
Sigue este pipeline para trabajo original de sitio personal:
- Aclara el propósito del sitio, la dirección del tema, el contenido disponible y el alcance de las páginas.
- Decide el mapa de páginas estáticas y la estrategia de marcadores de posición antes de codificar.
- Construye primero el esqueleto compartido: encabezado, navegación, diseño principal, pie de página, variables CSS globales e interacciones compartidas.
- Implementa la página de inicio y cada tipo de página solicitado o implícito.
- Usa el contenido del usuario o marcadores de posición claramente reemplazables; no inventes detalles de identidad personal detallados.
- Añade una guía de edición para futuras ediciones del modelo/usuario.
- Verifica la compatibilidad de rutas de apertura directa con enlaces y activos relativos.
- Valida localmente a través de HTTP en un navegador real.
- Verifica enlaces, activos, tipos de página y legibilidad del código fuente UTF-8 antes de la entrega final.
Usar Cuando
Usa este skill cuando el usuario:
- Quiere un sitio personal, blog, página de inicio, portafolio, página de inicio de investigación o sitio web estático en HTML/CSS/JS plano.
- Pide implementar una dirección de tema producida por
search-blog-theme. - Quiere un sitio simple sin framework que sea fácil de inspeccionar, editar y desplegar.
- Quiere rediseñar un sitio estático existente manteniéndolo libre de dependencias.
- Proporciona referencias visuales sueltas, pero no requiere una réplica de alta fidelidad.
No Usar Cuando
No uses este skill cuando:
- El usuario solo quiere buscar temas o comparar referencias visuales. Usa
search-blog-theme. - El usuario quiere recrear fielmente la apariencia, diseño, movimiento o sensación de interacción de un sitio web específico. Usa
copy-website-style. - El usuario quiere migrar muchas publicaciones, convertir notas de Obsidian, reparar frontmatter o mover grandes archivos de contenido. Usa
add-blog-posts. - El usuario solo necesita ayuda con despliegue, DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify o Vercel. Usa
publish-static-site. - El usuario solicita explícitamente un proyecto con framework como Next.js, Astro, Hugo, Jekyll, Quartz o React.
- El usuario pide un backend, base de datos, autenticación, CMS, sistema de comentarios o comportamiento de servidor dinámico.
Entradas
Usa lo que el usuario proporcione. No te detengas si faltan algunos detalles.
Las entradas útiles incluyen:
- Dirección de tema: archivo de código privado, panel de registro de investigación, jardín digital, portafolio bento, cuaderno de campo, sistema operativo personal, etc.
- Perfil de usuario: nombre, biografía corta, rol, ubicación, enlaces sociales, avatar, currículum, publicaciones, proyectos.
- Necesidades de página: inicio, acerca de, blog, proyectos, notas, publicaciones, contacto.
- Contenido de muestra: 1-3 publicaciones, descripciones de proyectos, fragmentos de Markdown, páginas HTML antiguas.
- Carpeta de sitio existente: archivos HTML/CSS/JS actuales para conservar o refactorizar.
- Referencias sueltas: v0, Figma, temas de GitHub, plantillas de framework, capturas de pantalla o referencias de estado de ánimo.
Regla de Referencia
Las referencias pueden venir de cualquier pila. Trátalas como referencias visuales y estructurales, no como elecciones de implementación, a menos que el usuario solicite explícitamente usar ese framework.
Para un sitio estático plano, traduce las referencias así:
- Componentes de React, Next o Astro -> secciones HTML repetidas con clases CSS reutilizables.
- Clases de utilidad de Tailwind -> reglas CSS normales en
assets/style.css. - Rutas de framework -> archivos
.htmlenlazados. - Colecciones de contenido o datos de CMS -> listas HTML estáticas o pequeños archivos JSON.
- Configuración de tema -> propiedades personalizadas CSS.
- Interacciones simples -> JavaScript vanilla solo cuando sea útil.
Si el usuario quiere coincidir fielmente con un sitio web específico, deriva a copy-website-style en lugar de tratarlo como una referencia suelta.
Estructura de Sitio Predeterminada
Para un sitio nuevo, prefiere esta estructura a menos que el usuario pida otra cosa:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
Para un sitio existente, conserva la estructura actual del usuario cuando sea práctico. No renombres ni reorganices grandes partes del sitio a menos que claramente mejore el trabajo solicitado.
Expectativas de Página
Crea solo las páginas necesarias para la solicitud del usuario. Para un iniciador de sitio personal completo, incluye:
- Inicio: identidad, introducción breve, área de héroe específica del tema, publicaciones recientes, proyectos seleccionados.
- Acerca de: biografía, intereses, habilidades, contacto, enlaces sociales, CV/publicaciones opcionales.
- Índice del blog: lista de publicaciones con título, fecha, etiquetas y resumen.
- Página de publicación: diseño de artículo legible con título, fecha, etiquetas, contenido y navegación de vuelta al índice del blog.
- Proyectos: tarjetas o filas de proyectos con descripción, pila, enlaces y resultado.
Mantén la primera pantalla útil. No crees una página de aterrizaje de marketing cuando el usuario pidió un sitio web personal o blog.
Para un iniciador de sitio personal o blog completo, no te detengas en una sola página de inicio. Crea tipos de página representativos funcionales, incluso cuando el contenido sea solo de marcador de posición:
- Al menos una página de artículo/detalle para un blog.
- Una página de lista o archivo cuando las publicaciones, notas, proyectos o publicaciones académicas sean parte del sitio.
- Una página de perfil/acerca de cuando la página de inicio enlace a identidad o detalles de fondo.
- Cualquier página especial implícita en el concepto elegido, como notas, enlaces, jardín, now, uses, publicaciones o experimentos.
Para grandes colecciones de contenido futuro, crea la estructura y algunas entradas de marcador de posición representativas en lugar de inventar un archivo completo.
Regla de Compatibilidad de Rutas
Los sitios estáticos planos generados deben funcionar cuando el usuario abre directamente index.html, cuando se sirven a través de HTTP local y cuando se despliegan en hosts estáticos comunes.
Reglas predeterminadas:
- Usa rutas relativas a la página para todos los enlaces y activos locales del sitio.
- Desde páginas raíz, enlaza CSS/JS/imágenes como
assets/style.css,assets/script.js,assets/images/avatar.pngy páginas comoabout.htmloposts/example.html. - Desde páginas anidadas como
posts/example.html, enlaza activos compartidos como../assets/style.cssy páginas raíz como../blog.htmlo../index.html. - No uses rutas absolutas de raíz del sitio como
/assets/style.css,/assets/script.js,/posts/example.html,/data/posts.json,/images/foo.pngo/a menos que el usuario acepte explícitamente comportamiento solo de raíz de servidor. - Aplica la misma regla a
url(...)en CSS, favicons, imágenes de Open Graph, imágenes de portada, fuentes, activos de proveedores KaTeX/math, enlaces RSS/sitemap y URLs generadas por JavaScript. - Al mover o añadir una página, recalcula las rutas basándote en la profundidad de carpeta de esa página en lugar de copiar enlaces de una página raíz.
Evita suposiciones solo de servidor:
- No te bases en
fetch("data/posts.json")u otras obtenciones de archivos locales para la navegación principal, listas de publicaciones o contenido de la página de inicio si la vista previa de apertura directa es parte de la promesa. - Si los datos repetidos son útiles, renderiza el contenido esencial directamente en HTML o almacena los datos en un objeto JavaScript local cargado con una etiqueta
<script src="assets/script.js">relativa. - Las mejoras opcionales pueden usar archivos de datos solo cuando la página aún se lea y navegue correctamente sin esa obtención.
Reglas de Estilo
Deja que el tema seleccionado guíe el lenguaje visual, pero mantén el sitio legible y mantenible.
- Pon el estilo de todo el sitio en
assets/style.css. - Usa propiedades personalizadas CSS para colores, espaciado, bordes y opciones tipográficas.
- Usa HTML semántico cuando sea posible:
header,nav,main,article,section,footer. - Usa reglas de diseño responsivo para que las páginas funcionen en móvil y escritorio.
- Haz que las páginas de artículo sean más tranquilas que la página de inicio si el tema es visualmente intenso.
- Prefiere fuentes del sistema a menos que el usuario pida una fuente específica o el tema la necesite fuertemente.
- No te bases en activos remotos a menos que el usuario los proporcione o sean claramente aceptables.
- No dejes que los efectos decorativos bloqueen la lectura, navegación o accesibilidad.
Reglas de Interacción
Usa JavaScript vanilla solo cuando añada valor claro.
Buenos usos:
- Alternancia de navegación móvil.
- Alternancia de tema.
- Filtrado ligero de etiquetas o publicaciones.
- Pequeños efectos progresivos que no afecten la lectura principal.
Evita:
- Frameworks de animación pesados.
- Decoración intensiva en Canvas a menos que el usuario lo solicite explícitamente.
- Efectos que requieran un servidor de desarrollo o instalación de paquetes.
- Parpadeo continuo, glitch agresivo o efectos de desplazamiento que perjudiquen la lectura.
Respeta prefers-reduced-motion para temas animados.
Regla de Simplificación Estática
Cuando una referencia suelta tenga características complejas o dependientes de framework, tradúcelas a equivalentes estáticos más simples:
- Globo 3D -> mapa de temas, panel de estado, constelación de proyectos o bloque visual estático.
- Cuadrícula bento animada -> cuadrícula CSS responsiva con estados hover sutiles.
- Simulador de terminal -> navegación temática y contenido estilo registro, no una línea de comandos falsa a menos que sea útil.
- Grafo de conocimiento -> etiquetas, publicaciones relacionadas, índice de temas o enlaces seleccionados manualmente.
- Búsqueda dinámica -> entrada de filtro simple, páginas de etiquetas estáticas o sin búsqueda para la primera versión.
- Publicaciones impulsadas por CMS ->
posts/*.htmlmásdata/posts.json.
Prefiere una versión estática limpia que capture la sensación deseada del usuario sobre una copia sobredimensionada de la referencia.
Regla de Sitio Existente
Al modificar un sitio existente:
- Inspecciona la estructura de archivos actual antes de editar.
- Conserva el contenido del usuario y archivos no relacionados.
- Mantén los cambios limitados a las páginas y activos solicitados.
- Reutiliza las convenciones visuales existentes cuando ya funcionen.
- Evita reemplazar todo el sitio a menos que el usuario pida un rediseño completo.
- Si el sitio ya tiene
style.cssoscript.js, extiéndelos cuidadosamente en lugar de crear duplicados conflictivos.
Regla de Contenido
Para pequeñas cantidades de contenido, escribe HTML estático directamente.
Para contenido repetido como publicaciones o proyectos, usa:
- HTML estático repetido cuando la lista sea corta.
- Un objeto de datos JavaScript local más renderizado con JavaScript vanilla cuando mejore la mantenibilidad.
- Un pequeño archivo JSON solo cuando se permita que el sitio requiera HTTP local/hosting estático para esa característica, y la página principal aún funcione sin él.
No inventes hechos personales detallados. Usa marcadores de posición claramente cuando falten datos del usuario.
Mantén los marcadores de posición fáciles de encontrar y reemplazar. Prefiere almacenar contenido repetido en un lugar claramente nombrado como data/*.json, un bloque de datos documentado en assets/script.js o una sección HTML repetida con nombres de clase estables.
Marca claramente el texto solo de marcador de posición, publicaciones de demostración, proyectos de muestra y enlaces simulados en los archivos o EDITING.md para que el usuario o un modelo futuro puedan reemplazarlos antes de publicar.
Regla de Guía de Edición
Al crear un sitio nuevo o rediseñar materialmente uno existente, incluye EDITING.md en la carpeta de salida.
EDITING.md está principalmente para un modelo o agente futuro que modificará el sitio generado más adelante. Mantenlo conciso pero concreto. Explica:
- Jerarquía de carpetas y para qué sirve cada archivo/carpeta.
- Formatos de archivo utilizados por el sitio: HTML, CSS, JS, JSON/bloques de datos e imágenes.
- Mapa de páginas: qué archivo generado es inicio, acerca de/perfil, blog/lista, artículo/detalle, proyectos, notas, enlaces u otros tipos de página.
- Regiones de diseño compartido: encabezado, navegación, navegación móvil, contenido principal, pie de página, barras laterales, superposiciones o controles de tema.
- Dónde vive cada región principal de la página de inicio en
index.html, usando nombres de sección/clase cercanos. - Dónde está cada plantilla de subpágina y cómo los enlaces internos se conectan a ella.
- Dónde se almacena el contenido repetido y su formato esperado de objeto/marcado.
- Cómo cambiar el título del sitio, eslogan, avatar/logotipo, navegación, publicaciones destacadas, listas de proyectos, listas de enlaces, imágenes, colores y variables de tema.
- Qué contenido es solo de marcador de posición y debe reemplazarse antes de publicar.
Regla de Integridad de Codificación
Los archivos fuente generados deben ser UTF-8 válidos y legibles por humanos en forma fuente, no solo de aspecto correcto en capturas de pantalla del navegador.
Para páginas o guías de edición que contengan texto en chino, japonés, coreano, latín acentuado u otro contenido no ASCII:
- Incluye
<meta charset="utf-8">en los archivos HTML. - Escribe los archivos como UTF-8.
- Verifica la legibilidad del código fuente con un lector compatible con UTF-8 antes de la entrega final.