Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Crea, rediseña o actualiza un sitio web personal (blog, portafolio, página de inicio) estático, sin dependencias, usando HTML, CSS y JavaScript vanilla, listo para abrir en el navegador y desplegar como archivos estáticos.

¿Qué es from-idea-to-personal-site?

Este skill está diseñado para crear o rediseñar un sitio web personal completamente estático, sin frameworks, sin paso de construcción y sin dependencias. Es ideal cuando el usuario ya tiene una dirección de tema visual y necesita llevarla a la práctica. El skill transforma recomendaciones de tema, perfiles de usuario, contenido de muestra o una carpeta existente en un sitio funcional basado únicamente en HTML, CSS y JavaScript vanilla. Garantiza que el sitio funcione al abrir `index.html` directamente en el navegador, a través de un servidor HTTP local o desplegado en cualquier hosting estático, utilizando rutas relativas para enlaces y activos. El resultado incluye las páginas necesarias (inicio, blog, proyectos, acerca de), un archivo `EDITING.md` para futuras ediciones, y sigue reglas estrictas de codificación UTF-8 y compatibilidad de rutas. No debe usarse para clonar sitios específicos, importar grandes archivos de contenido, añadir frameworks o bases de datos, ni para tareas de despliegue; esas funciones corresponden a otros skills especializados.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/make-personal-site

Preguntar en tu IA favorita

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

Documentación

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.html directamente 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.md para 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-site puede 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-site cuando el fallo sea la falta de identidad/contenido del usuario.
  • Vuelve a usar review-static-site después de las correcciones.

Pipeline Corto

Sigue este pipeline para trabajo original de sitio personal:

  1. Aclara el propósito del sitio, la dirección del tema, el contenido disponible y el alcance de las páginas.
  2. Decide el mapa de páginas estáticas y la estrategia de marcadores de posición antes de codificar.
  3. Construye primero el esqueleto compartido: encabezado, navegación, diseño principal, pie de página, variables CSS globales e interacciones compartidas.
  4. Implementa la página de inicio y cada tipo de página solicitado o implícito.
  5. Usa el contenido del usuario o marcadores de posición claramente reemplazables; no inventes detalles de identidad personal detallados.
  6. Añade una guía de edición para futuras ediciones del modelo/usuario.
  7. Verifica la compatibilidad de rutas de apertura directa con enlaces y activos relativos.
  8. Valida localmente a través de HTTP en un navegador real.
  9. 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 .html enlazados.
  • 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.png y páginas como about.html o posts/example.html.
  • Desde páginas anidadas como posts/example.html, enlaza activos compartidos como ../assets/style.css y páginas raíz como ../blog.html o ../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.png o / 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/*.html más data/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.css o script.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.

Individual skills in this repo

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

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Skills relacionados