Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Organiza y coordina el conjunto de habilidades para sitios web personales, permitiendo crear, recrear, personalizar, agregar contenido, validar, editar o preparar un sitio web o blog estático. Úsalo cuando el agente necesite elegir entre búsqueda de temas, investigación de referencias de estilo, construcción original, recreación de estilo, personalización, importación de publicaciones, revisión, ediciones locales o preparación para publicación, o cuando el usuario pregunte cuál es el siguiente paso en un flujo de trabajo existente de construcción de sitios.

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

Esta habilidad de orquestación, `Gyschuaner/from-idea-to-personal-site`, actúa como un coordinador de flujo de trabajo para construir y gestionar sitios web personales estáticos. En lugar de implementar detalles técnicos por sí misma, enruta las solicitudes a habilidades hijas especializadas, como `make-personal-site` para la construcción inicial, `search-blog-theme` para descubrir temas, `copy-website-style` para recrear sitios de referencia, y `review-static-site` para la garantía de calidad. Soporta plataformas como GitHub Pages, Cloudflare Pages, Netlify y Vercel para la implementación final, pero solo después de una validación local exhaustiva. Su propósito es guiar al usuario desde una idea vaga hasta un sitio validado localmente, asegurando que se cumplan las puertas de calidad (como verificación de estructura, contenido, rutas y codificación) antes de cualquier paso de publicación. La habilidad prioriza la eficiencia eligiendo la cadena más corta de habilidades hijas que satisfaga la solicitud, evitando ejecutar habilidades innecesarias. Esto la hace especialmente útil para desarrolladores y agentes de IA que necesitan un flujo de trabajo confiable y paso a paso para gestionar sitios web personales, desde la ideación hasta la preparación para producción.

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

Preguntar en tu IA favorita

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

Documentación

Construir Sitio Personal

Objetivo

Coordinar el conjunto de habilidades del sitio personal en un flujo de trabajo confiable.

Esta es una habilidad de orquestación, no una habilidad de implementación. Debe enrutar a las habilidades especializadas correctas, hacer cumplir las puertas de calidad y mantener el flujo de trabajo en movimiento hasta que la solicitud actual alcance su punto de parada natural.

No dupliques las reglas de implementación detalladas de las habilidades hijas. Carga y sigue las habilidades hijas cuando se alcance su paso.

Para solicitudes orientadas al usuario de "de la idea al sitio personal" o de lanzamiento con un clic, prefiere from-idea-to-personal-site. Usa esta habilidad como el coordinador de ruta de nivel inferior cuando el siguiente paso o la elección de la habilidad hija sea el problema principal.

Contrato

Entradas:

  • Solicitud del usuario, carpeta del sitio o carpeta de salida deseada, referencias, materiales de identidad, materiales de contenido y destino de publicación opcional.
  • Estado actual del flujo de trabajo cuando el usuario pregunta qué hacer a continuación.

Salidas:

  • Ruta de flujo de trabajo elegida y habilidades hijas ejecutadas.
  • Un sitio estático local, sitio existente validado, contenido importado, edición enfocada o preparación para publicación según la solicitud.
  • Resumen de transferencia con carpeta del sitio, estado de vista previa/publicación, validación realizada y pasos manuales restantes.

Límites:

  • No implementes detalles de habilidades hijas directamente cuando una habilidad hija especializada sea aplicable.
  • No ejecutes todas las habilidades hijas por defecto; elige la cadena más corta que satisfaga la solicitud.
  • No publiques, hagas push, crees proyectos, vincules dominios ni cambies DNS a menos que se solicite explícitamente.
  • No omitas review-static-site después de la generación, recreación, personalización, importación de publicaciones o ediciones amplias.

Puerta de éxito:

  • La cadena de habilidades hijas elegida alcanza el punto de parada natural del usuario: dirección seleccionada, sitio construido, contenido agregado, sitio validado, edición completada o implementación preparada/realizada.
  • Las puertas de calidad requeridas pasan o el usuario acepta explícitamente las limitaciones documentadas.

Si la puerta falla:

  • Enruta la puerta fallida a la habilidad hija responsable más pequeña.
  • Vuelve a ejecutar la validación afectada.
  • Detente e informa del bloqueador solo cuando falte contenido del usuario, credenciales faltantes, activos no disponibles o acciones de cuenta externa impidan el progreso.

Habilidades Hijas

Usa estas habilidades como los bloques de construcción del flujo de trabajo:

  • search-blog-theme: descubre y compara direcciones de temas para sitios web personales/blogs.
  • find-style-references: busca e inspecciona sitios web/plantillas/capturas de pantalla reales para una dirección elegida y produce un breve resumen de referencia listo para construir.
  • make-personal-site: crea un sitio personal estático original sin dependencias.
  • copy-website-style: recrea el estilo, diseño, movimiento y tipos de página de un sitio web de referencia específico.
  • personalize-site: reemplaza el contenido de marcador de posición/demo/fuente con el contenido propio del usuario.
  • add-blog-posts: importa Markdown, notas de Obsidian, borradores de Word, publicaciones HTML antiguas, imágenes, matemáticas, enlaces y otros escritos a un sitio existente.
  • edit-site-part: realiza cambios locales enfocados en una sección, componente, bloque de copia, detalle de estilo o interacción específicos.
  • review-static-site: valida la salida estática en busca de enlaces, tipos de página, renderizado del navegador, codificación, residuos de marcadores de posición, compatibilidad de apertura directa y corrección de rutas.
  • publish-static-site: prepara o realiza la implementación en GitHub Pages, Cloudflare Pages, Netlify o Vercel.

Si el nombre de una habilidad hija cambia, prefiere la habilidad instalada localmente con el propósito coincidente.

Matriz de Contrato de Habilidades Hijas

Usa esta matriz para decidir transferencias y bucles de reparación:

Habilidad hijaEntrada requeridaSalida esperadaPuerta de éxitoSi la puerta falla
search-blog-themeGusto del usuario, propósito, referencias o palabras clave3-5 direcciones, URLs de referencia verificadas, una recomendaciónLa dirección es lo suficientemente específica para construirBuscar más referencias, afinar la metáfora o hacer una pregunta de preferencia
find-style-referencesDirección de estilo elegida, tipo de sitio, palabras de ambiente o ejemplos4-8 referencias reales, observaciones del navegador, resumen de diseño listo para construirMúltiples ángulos de búsqueda y al menos 3 referencias sólidas inspeccionadas cuando sea posibleAmpliar la búsqueda, inspeccionar referencias más sólidas o volver a search-blog-theme
make-personal-siteDirección, pistas de contenido/perfil, alcance de página, carpeta de salidaSitio estático simple con páginas representativas, activos, EDITING.mdTipos de página requeridos, rutas relativas, fuente UTF-8, vista previa localArreglar estructura/rutas/activos, luego review-static-site
copy-website-styleURL/captura de pantalla/plantilla de destino y alcanceRecreación de estilo estático con mapa de página, marcadores de posición/contenido de usuario, EDITING.mdDiseño/movimiento/tipos de página característicos coinciden con la fidelidad solicitadaReinspeccionar el objetivo, iterar la recreación, luego review-static-site
personalize-siteSitio existente más identidad/contenido del usuarioIdentidad reemplazada, enlaces, metadatos, activos, limpieza de marcadores de posición/fuenteContenido del usuario visible y residuos eliminadosReinventariar las ubicaciones de contenido o usar edit-site-part para el ajuste del diseño
add-blog-postsSitio existente más publicaciones/activos de origenNuevas páginas de publicaciones, índices/datos actualizados, activos copiados, notas de ediciónLas publicaciones se renderizan, enlaces/activos/matemáticas/contenido enriquecido funcionanArreglar conversión/índice/activos o usar edit-site-part para problemas de presentación local
edit-site-partSitio existente más página/región/cambio de destinoEdición pequeña y enfocada de código/contenido/estilo/interacciónLa misma región del navegador muestra el cambio solicitado sin roturas no relacionadasReasignar fuente y hacer una edición correctiva más pequeña
review-static-siteRaíz estática, alcance esperado, cadenas prohibidas/referencia opcionalesHallazgos o correcciones, resultado de auditoría/navegador, estado de aprobación/rechazoNo quedan bloqueadoresEnrutar el bloqueador a la habilidad hija responsable más pequeña
publish-static-siteRaíz de implementación validada más plataforma/modo elegidosConfiguraciones/archivos de implementación, URL en vivo opcional, verificación posterior a la implementaciónCarpeta correcta implementada y URL en vivo funcionaArreglar bloqueadores locales, configuraciones de implementación o pasos de cuenta/DNS

Principios Operativos

  • Enruta primero, luego ejecuta. Decide la cadena correcta antes de hacer ediciones amplias.
  • Mantén la salida de cada paso utilizable por el siguiente paso.
  • Prefiere HTML/CSS/JS simple y cero dependencias para esta versión a menos que el usuario solicite explícitamente otra pila.
  • No conviertas un sitio personal o blog en una página de destino de marketing.
  • No inventes hechos personales detallados cuando falten datos del usuario.
  • Reemplaza la identidad de la fuente copiada por defecto en las recreaciones de estilo.
  • Usa enlaces y activos relativos a la página por defecto; evita rutas absolutas locales del sitio como /assets/... o /posts/....
  • Valida con review-static-site después de cualquier generación, recreación, personalización, importación de publicaciones o edición amplia.
  • Detente en un sitio local validado a menos que el usuario solicite explícitamente publicar.
  • No crees repositorios, hagas push de código, implementes, vincules dominios ni cambies DNS a menos que el usuario lo solicite explícitamente.

Recepción

Recopila solo la información necesaria para la siguiente decisión. No entrevistes al usuario en exceso.

Entradas útiles:

  • Carpeta de salida deseada o carpeta del sitio existente.
  • Si el usuario quiere un sitio nuevo, una recreación de una referencia, importación de contenido, personalización, una edición local, validación o publicación.
  • URLs de referencia, capturas de pantalla, plantillas o palabras de tema.
  • Materiales de identidad del usuario: nombre, biografía, enlaces, currículum, proyectos, avatar/logo, página de inicio antigua, perfil de GitHub.
  • Materiales de contenido: Markdown, notas de Obsidian, documentos de Word, publicaciones antiguas, carpetas de imágenes o texto pegado.
  • Destino de publicación: GitHub Pages, Cloudflare Pages, Netlify, Vercel o solo orientación.

Si la solicitud es lo suficientemente clara, procede. Haz una pregunta concisa solo cuando múltiples rutas producirían un trabajo muy diferente.

Enrutador

Elige el flujo de trabajo según el estado actual del usuario:

  • Idea vaga o "encuéntrame un estilo": usa search-blog-theme, luego find-style-references antes de una construcción original.
  • Dirección elegida y sin sitio de destino específico: usa find-style-references, luego make-personal-site.
  • URL/captura de pantalla/plantilla de destino específica para coincidir estrechamente: usa copy-website-style.
  • Sitio generado existente que aún tiene marcadores de posición o identidad copiada: usa personalize-site.
  • Sitio existente más nuevos artículos/notas/documentos: usa add-blog-posts.
  • Sitio existente más un pequeño cambio visual/de copia/diseño/interacción: usa edit-site-part.
  • "Revisa este sitio", "¿es lo suficientemente bueno?", "antes de publicar": usa review-static-site.
  • "Implementa", "publica", "GitHub Pages", "Cloudflare Pages", "Netlify", "Vercel": usa publish-static-site, después de review-static-site.

Cuando el usuario solicite una construcción completa con un clic, elige la cadena más corta que maneje las entradas reales. No ejecutes todas las habilidades hijas solo porque existen.

Ejemplos de Ruta

Usa estos ejemplos para estabilizar el enrutamiento:

Patrón de solicitud del usuarioRuta
"Quiero un blog personal distintivo, ayúdame a elegir un estilo"search-blog-theme
"Encuentra referencias reales para este estilo elegido antes de construir"find-style-references
"Hazme un sitio personal en esta dirección elegida"find-style-references -> make-personal-site -> review-static-site
"Construye un blog personal completo desde cero"search-blog-theme si es necesario -> find-style-references -> make-personal-site -> personalize-site si existe contenido -> review-static-site
"Usa esta URL como referencia y recréala"copy-website-style -> personalize-site -> review-static-site
"Copia este sitio web pero reemplaza el contenido de la persona con el mío"copy-website-style -> personalize-site -> review-static-site
"Aquí está mi sitio generado, reemplaza los marcadores de posición con mi biografía/proyectos/enlaces"personalize-site -> review-static-site
"Agrega este artículo de Markdown/Obsidian/Word al sitio"add-blog-posts -> review-static-site
"Cambia esta sección/color/título/tarjeta/menú"edit-site-part; agrega review-static-site solo si la estructura compartida o los activos cambiaron
"Verifica si este sitio está listo"review-static-site
"Implementa esto en Cloudflare Pages/GitHub Pages/Netlify/Vercel"review-static-site -> publish-static-site
"Funciona localmente a través de HTTP pero no al hacer doble clic en index.html"review-static-site; arregla fallas de puerta de ruta antes de publicar

Tuberías Estándar

De la Idea al Sitio Original

Úsalo cuando el usuario solo tenga un objetivo aproximado o preferencia de estilo.

  1. search-blog-theme si la dirección visual no está clara.
  2. find-style-references para basar la dirección elegida en sitios web/plantillas/capturas de pantalla reales.
  3. make-personal-site para crear el sitio estático.
  4. personalize-site si el usuario proporcionó identidad/contenido o el sitio tiene marcadores de posición que deben llenarse.
  5. review-static-site como la puerta de control de calidad estricta.
  6. Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.

De la Referencia al Sitio Personal

Úsalo cuando el usuario proporcione una URL de destino, captura de pantalla, plantilla v0, diseño de Figma o sitio web existente para coincidir.

  1. copy-website-style para recrear el diseño, movimiento, tipos de página e interacciones.
  2. personalize-site para reemplazar la identidad de destino y el contenido de marcador de posición.
  3. add-blog-posts si el usuario proporcionó contenido de escritura.
  4. review-static-site como la puerta de control de calidad estricta.
  5. Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.

Blog Primero el Contenido

Úsalo cuando la entrada más sólida del usuario sean artículos, notas, Markdown, archivos de Word o un archivo de escritura antiguo.

  1. Usa search-blog-theme solo si no existe sitio/tema.
  2. Usa find-style-references si se necesita un nuevo sistema visual original.
  3. Usa make-personal-site si aún no existe un sitio estático.
  4. Usa add-blog-posts para importar el contenido al sistema de publicaciones del sitio existente.
  5. Usa personalize-site si el contenido de identidad/perfil sigue siendo genérico.
  6. Usa review-static-site como la puerta de control de calidad estricta.
  7. Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.

Mejora de Sitio Existente

Úsalo cuando el usuario ya tenga una carpeta de sitio generado.

  1. Inspecciona el sitio y EDITING.md si está presente.
  2. Usa personalize-site para el reemplazo de identidad/contenido.
  3. Usa add-blog-posts para importaciones de artículos.
  4. Usa edit-site-part para cambios de diseño o copia enfocados.
  5. Usa review-static-site cuando el cambio afecte la navegación, tipos de página, activos, codificación, preparación para publicación o más de una página.

Sitio Listo para Publicar

Úsalo cuando el usuario solicite publicar o implementar.

  1. Usa review-static-site primero.
  2. Arregla bloqueadores o enruta a la habilidad hija relevante si la revisión encuentra problemas.
  3. Usa publish-static-site solo después de que el sitio pase las verificaciones locales necesarias o el usuario acepte riesgos conocidos.
  4. Verifica la URL en vivo cuando ocurra la implementación.

Puertas de Calidad

El flujo de trabajo no termina hasta que las puertas relevantes pasen o el usuario acepte una limitación explícita.

Puerta de tema:

  • La dirección visual o la referencia es lo suficientemente específica para construir.
  • Si la construcción es original y se basa en palabras de gusto, se han buscado referencias de estilo reales desde múltiples ángulos y se han inspeccionado al menos 3 referencias sólidas cuando sea posible, o el usuario renunció explícitamente a ese paso.
  • El enfoque elegido coincide con el tipo de sitio del usuario: blog, portafolio, página de inicio de investigación, jardín digital, notas, enlaces o híbrido.

Puerta de estructura:

  • Existen los tipos de página requeridos, no solo la página de inicio.
  • Los sitios similares a blogs incluyen al menos una página de artículo/detalle y un punto de entrada de lista/archivo.
  • La navegación apunta a páginas generadas reales.

Puerta de contenido:

  • La identidad/contenido proporcionado por el usuario aparece en los lugares previstos.
  • El contenido solo de marcador de posición está claramente marcado o reemplazado.
  • La identidad del sitio de origen copiado se elimina de las recreaciones de estilo a menos que el usuario la posea o tenga permiso.

Puerta de ruta:

  • Los enlaces y activos locales del sitio son relativos a la página por defecto.
  • Las páginas anidadas usan la profundidad correcta ../.
  • HTML, CSS url(...), enlaces generados por JavaScript, archivos de datos, imágenes de portada, fuentes y activos de proveedor evitan rutas absolutas accidentales.
  • La apertura directa de index.html no debe perder CSS, JS, imágenes ni navegación.

Puerta de codificación:

  • Todo el código fuente HTML, CSS, JS y de datos es UTF-8 sin BOM.
  • No se utilizan caracteres escapados o entidades HTML para caracteres fuera de ASCII cuando está disponible la codificación UTF-8 adecuada.
  • Los metadatos de idioma (atributo lang en <html>) coinciden con el contenido real.
  • Las páginas mixtas (por ejemplo, publicaciones de blog en inglés en un sitio español) pueden tener metadatos de idioma en el nivel de la página.
  • Las entradas mixtas (por ejemplo, publicaciones con caracteres japoneses, árabes o cirílicos) se renderizan correctamente.

Puerta del navegador:

  • El sitio se abre en navegadores de escritorio y móviles modernos (Chrome, Firefox, Safari, Edge) sin errores de consola de JavaScript.
  • El estilo visual no se rompe por diferencias de navegador.
  • Las interacciones planificadas (menús, acordeones, galerías, clics/desplazamiento suave) funcionan.
  • Las páginas tienen un tamaño, espaciado y legibilidad razonables en tamaños de ventana de escritorio y dispositivos móviles comunes.
  • Las páginas de error 404 personalizadas se sirven correctamente sin ruptura de CSS/ruta.
  • El contenido importado que depende de JavaScript, iframes embebidos o fuentes externas se carga en contextos de archivo local. Si no, se documenta explícitamente como una limitación conocida.

Puerta de preparación para publicación:

  • Todas las puertas anteriores pasan.
  • La estrategia de implementación coincide con la plataforma del usuario: construcción desde la fuente adecuada, configuración de ruta y metadatos.
  • No hay dependencias de construcción que la plataforma no pueda ejecutar.
  • Los activos, fuentes y API de terceros se sirven desde rutas/URLs que funcionarán en producción.
  • Las variables de entorno requeridas están documentadas.

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

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 when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

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