Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Usa esta habilidad para añadir, importar o migrar una o más entradas de blog, notas, ensayos, artículos, archivos Markdown, documentos de Word o carpetas de contenido enriquecido a un sitio web o blog personal estático existente, preservando el estilo actual de los artículos, la estructura de contenido, la navegación, los índices, archivos, etiquetas, activos, matemáticas, enlaces, tablas, bloques de código, incrustaciones y puntos de entrada de la página de inicio. Úsala para publicaciones pegadas, archivos Markdown locales, notas de Obsidian, borradores .docx, publicaciones HTML estáticas antiguas, contenido exportado de blogs o lotes pequeños a medianos de publicaciones después de que el sitio ya se haya creado.

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

Esta skill está diseñada para añadir contenido a un sitio web personal estático existente sin forzar un cambio en el sistema de blog actual. Su objetivo es comprender primero cómo el sitio representa ya las publicaciones (incluyendo plantillas, índices, archivos de datos, manejo de rutas y activos) y luego añadir nuevas publicaciones siguiendo ese mismo estilo visual y estructural. Es compatible con múltiples formatos de origen como Markdown, notas de Obsidian, documentos de Word, HTML antiguo y texto pegado, y se encarga de extraer metadatos, convertir contenido enriquecido (matemáticas, código, tablas, notas al pie, imágenes, diagramas) y actualizar todos los puntos de entrada relevantes como la página de inicio, el archivo, las etiquetas y el RSS. La skill se ejecuta en sistemas de agentes de IA como Claude Code, Cursor o Codex, y sigue un proceso estructurado: entender el sistema de publicaciones actual, extraer metadatos, convertir el contenido, preservar rutas relativas a la página, manejar activos e imágenes, y finalmente verificar el éxito mediante la revisión del sitio, reportando cualquier elemento no resuelto.

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

Preguntar en tu IA favorita

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

Documentación

Añadir Publicaciones de Blog

Objetivo

Añadir contenido del usuario a un blog estático existente sin forzar un nuevo sistema de blog.

Esta habilidad debe primero entender cómo el sitio actual ya representa las publicaciones, y luego añadir nuevo contenido en ese estilo. No es un convertidor genérico de Markdown a HTML.

Contrato

Entradas:

  • Carpeta del sitio estático existente y su sistema actual de publicaciones/índices/plantillas.
  • Una o más publicaciones de origen: Markdown, notas de Obsidian, documentos de Word, HTML antiguo, texto pegado, imágenes, archivos adjuntos o carpetas de contenido.
  • Metadatos opcionales como título, fecha, etiquetas, resumen, slug, imagen de portada y alcance de la importación.

Salidas:

  • Nuevas páginas de artículo/detalle que coinciden con el estilo de artículo existente del sitio.
  • Puntos de entrada actualizados, como índice del blog, archivo, etiquetas/categorías, publicaciones recientes en la página de inicio, datos de búsqueda, RSS o mapa del sitio cuando esos sistemas ya existen.
  • Imágenes y archivos adjuntos locales copiados/reenlazados con rutas relativas a la página.
  • Instrucciones de publicación EDITING.md actualizadas cuando sea aplicable.

Límites:

  • No rediseñar el sitio ni crear un nuevo sistema de publicaciones cuando exista uno claro.
  • No inventar metadatos, fechas, autores o afirmaciones que la fuente no respalde.
  • No añadir dependencias remotas de matemáticas/CDN silenciosamente.
  • No publicar; usar publish-static-site.

Puerta de éxito:

  • Las nuevas publicaciones se renderizan en el estilo existente y son accesibles desde los índices apropiados.
  • Las imágenes, matemáticas, enlaces, código, tablas y contenido enriquecido funcionan, o los elementos no resueltos se reportan explícitamente.
  • Las rutas son relativas a la página desde los artículos y las páginas de índice.
  • Las páginas afectadas pasan la validación del navegador y review-static-site puede pasar o solo reportar limitaciones aceptadas.

Si la puerta falla:

  • Corregir la conversión, metadatos, rutas, activos o cableado del índice en esta habilidad.
  • Usar edit-site-part para pequeñas correcciones visuales causadas por la importación.
  • Usar review-static-site nuevamente después de las correcciones.

Cuándo Usar

Usa esta habilidad cuando el usuario quiera:

  • Añadir un nuevo artículo, nota, ensayo o publicación de blog.
  • Importar varios archivos Markdown a un sitio estático.
  • Mover publicaciones de un blog antiguo a un nuevo sitio generado.
  • Convertir texto de artículo pegado en una página de artículo del sitio.
  • Actualizar el índice del blog, archivo, etiquetas, publicaciones recientes en la página de inicio o puntos de entrada relacionados.
  • Preservar el lenguaje visual del sitio actual mientras se añade contenido.

No uses esta habilidad para elegir un tema, construir un sitio nuevo desde cero, recrear el estilo de un sitio web, personalizar contenido de perfil/acerca de, hacer un pequeño ajuste visual, publicar el sitio o convertir el proyecto a un framework.

Entradas

Usa lo que esté disponible:

  • Carpeta del sitio estático, usualmente site/, dist/, out/ o public/.
  • Uno o más archivos Markdown, documentos de Word, publicaciones pegadas, archivos HTML antiguos, carpetas de imágenes o carpetas de contenido.
  • EDITING.md, mapa de páginas o notas de traspaso de habilidades anteriores.
  • Páginas de plantilla de artículo existentes o publicaciones representativas.
  • Título, fecha, etiquetas, categoría, resumen, slug, imagen de portada y preferencia de publicación proporcionados por el usuario.
  • Si importar todas las publicaciones, un subconjunto seleccionado o un lote representativo primero.

Si el contenido de origen es grande, inspecciona la estructura primero y evita importar todo a ciegas.

1. Entender el Sistema de Publicaciones Existente

Antes de escribir nuevas publicaciones, inspecciona cómo funciona actualmente el sitio.

Verifica:

  • Archivos de publicación como posts/*.html, notes/*.html, articles/*.html o carpetas de rutas anidadas.
  • Páginas de índice como blog.html, archive/index.html, notes/index.html, tags/index.html o category/index.html.
  • Archivos de datos como data/posts.json, data/notes.json, data/site.json o profile.json.
  • Arreglos de datos JavaScript en assets/script.js o archivos similares.
  • Secciones de la página de inicio para publicaciones recientes, publicaciones destacadas, notas, listas de lectura o destacados de escritura.
  • Páginas de artículo/detalle existentes que se puedan usar como plantillas.
  • Estrategia de rutas existente: si las plantillas usan enlaces relativos a la página como ../assets/style.css o enlaces raíz del servidor como /assets/style.css.
  • RSS, Atom, mapa del sitio, índice de búsqueda o páginas de etiquetas/categorías si ya están presentes.
  • Instrucciones de EDITING.md para añadir publicaciones.
  • Convenciones existentes de imágenes y archivos adjuntos, como assets/images/posts/, carpetas de publicaciones colocalizadas, campos de portada, clases de figura, marcado de lightbox, leyendas o envoltorios de imágenes responsivas.
  • Convenciones existentes de contenido enriquecido, como renderizado de matemáticas, resaltado de código, tablas, notas al pie, callouts, anclajes de encabezados, tabla de contenidos, tarjetas de enlace, incrustaciones, diagramas y secciones de citas/referencias.

Sigue la estructura existente. No inventes un nuevo sistema de publicaciones cuando el sitio ya tenga uno.

2. Extraer Metadatos de la Publicación

Para cada publicación de origen, extrae o deriva:

  • Título.
  • Fecha.
  • Slug.
  • Etiquetas o categoría.
  • Resumen o extracto.
  • Imagen de portada o imagen hero, si está presente y es utilizable.
  • Ruta de origen.
  • Tiempo de lectura, solo si el sitio actual ya lo usa o es fácil de calcular de manera consistente.

Usa frontmatter cuando esté presente. De lo contrario, infiere del primer encabezado, nombre de archivo, carpeta circundante, texto de fecha visible o primer párrafo.

No inventes fechas, etiquetas, autores o afirmaciones específicas. Si falta un campo y no se puede inferir, usa un marcador de posición claro u omite el campo cuando el estilo del sitio lo permita.

3. Convertir el Contenido al Estilo del Sitio

Crea nuevas páginas de artículo coincidiendo con la plantilla de artículo existente y la experiencia de lectura.

Preserva:

  • Encabezado, navegación, pie de página, barras laterales y caparazón compartido.
  • Tipografía del artículo, espaciado, diseño de metadatos, etiquetas, enlaces de retorno y enlaces relacionados.
  • Cualquier lenguaje de tema especial, como entradas de registro, notas de campo, tarjetas, marcos de terminal/archivo o ensayos mínimos.
  • Convenciones de clases CSS existentes y estructuras de datos.

Para Markdown:

  • Convierte encabezados, párrafos, blockquotes, listas, listas de tareas, tablas, bloques de código, enlaces, notas al pie, callouts e imágenes en HTML semántico.
  • Preserva las etiquetas de idioma del código cuando estén disponibles.
  • Mantén las referencias de imágenes relativas a la página y copia las imágenes locales solo cuando sea necesario.
  • Mantén el texto chino, japonés, coreano, latín acentuado y otro texto no ASCII como UTF-8 legible.

Para HTML antiguo:

  • Extrae el cuerpo del artículo y los metadatos.
  • Elimina el cromo antiguo del sitio, análisis, comentarios, navegación no relacionada e identidad del sitio de origen.
  • Vuelve a envolver el contenido en la plantilla de artículo del nuevo sitio.

3.5. Preservar la Compatibilidad de Rutas Estáticas

Al añadir publicaciones, calcula las rutas desde la ubicación de cada página generada. No copies rutas de index.html a ciegas en páginas de artículo anidadas.

Reglas predeterminadas:

  • Las nuevas páginas de artículo deben usar enlaces relativos a la página para CSS, JavaScript, fuentes, imágenes y navegación compartidos.
  • Si la publicación se genera en posts/my-post.html, los activos compartidos usualmente necesitan ../assets/style.css, ../assets/script.js e imágenes de publicación como ../assets/images/posts/my-post/figure.png.
  • Los enlaces desde las páginas raíz a la publicación usualmente deben ser posts/my-post.html.
  • Los enlaces desde la publicación de vuelta a las páginas raíz usualmente deben ser ../index.html, ../blog.html o ../archive/index.html, dependiendo de la estructura.
  • No introduzcas rutas absolutas de raíz como /assets/..., /posts/..., /data/... o /images/... a menos que el sitio existente las use intencionalmente y el usuario acepte que la apertura directa con file:// y el alojamiento en subrutas puedan romperse.
  • Actualiza los enlaces generados por JavaScript, resultados de búsqueda, filtros de etiquetas, enlaces de publicaciones relacionadas, rutas de portada, entradas de RSS/mapa del sitio y cualquier archivo de datos con la misma estrategia de ruta.
  • Si el sitio existente ya tiene enlaces absolutos de raíz por accidente, repórtalo y prefiere corregir las rutas afectadas en lugar de extender el problema.

Evita problemas de fetch de archivos locales:

  • No hagas que las nuevas publicaciones añadidas dependan de fetch() de JSON/Markdown local para el cuerpo del artículo.
  • Si los índices se renderizan a partir de datos, mantén los enlaces esenciales de las publicaciones visibles en HTML o usa un objeto de datos JavaScript relativo que funcione con la vista previa de apertura directa.

4. Manejar Formatos de Contenido Enriquecido

Preserva el contenido enriquecido intencionalmente en lugar de aplanarlo todo en párrafos simples.

Primero inspecciona si el sitio actual ya soporta:

  • Renderizado de matemáticas con KaTeX, MathJax, CSS personalizado o bloques TeX sin procesar.
  • Resaltado de código, etiquetas de idioma, botones de copia o marcos de código estilo terminal.
  • Tablas, envoltorios de tablas responsivas, notas al pie, callouts, admoniciones, citas y listas de tareas.
  • Anclajes de encabezados, tabla de contenidos, backlinks, notas relacionadas o enlaces de sección.
  • Tarjetas de enlace, listas de marcadores, páginas de índice de URL, citas, listas de referencias o secciones de bibliografía.
  • Medios incrustados como video, audio, PDFs, iframes, diagramas Mermaid, diagramas Excalidraw/SVG o archivos adjuntos descargables.

Sigue el patrón existente cuando exista uno. Si no existe ningún patrón, usa HTML semántico simple y reporta cualquier característica que necesite un renderizador adicional.

Matemáticas y fórmulas:

  • Preserva las matemáticas en línea y en display de $...$, $$...$$, \(...\), \[...\] o exportaciones de ecuaciones de Word.
  • Usa el renderizador de matemáticas existente del sitio si está presente.
  • Si la fuente contiene muchas fórmulas y no existe un renderizador, prefiere una integración local de KaTeX para sitios estáticos simples: almacena CSS/JS/fuentes de KaTeX bajo una carpeta de proveedor local, añade un pequeño script de renderizado local y no dependas de un CDN.
  • No añadas silenciosamente una dependencia remota de MathJax/KaTeX a un sitio que de otro modo no tiene dependencias.
  • Preserva el TeX original dentro de elementos marcados con matemáticas como respaldo, luego renderízalo en el navegador. Si el renderizado falla para una fórmula, el respaldo de TeX legible debe permanecer visible en lugar de romper la página.
  • Normaliza la sintaxis de origen obvia que KaTeX necesita, como flechas de softmax, \cdot, \times, puntuación accidentalmente mezclada en fórmulas y expresiones comunes Q/K/V.
  • No dejes publicaciones con muchas fórmulas como cajas TeX con aspecto de código cuando se haya añadido un renderizador de matemáticas.
  • Mantén las fórmulas legibles en la fuente y en el respaldo del navegador.

Bloques de código:

  • Preserva los nombres de idioma de los bloques de código delimitados.
  • Escapa el HTML dentro de los bloques de código.
  • Mantén las líneas de código largas desplazables en lugar de romper el diseño de la página.
  • Reutiliza el estilo de bloque de código existente, botones de copia y convenciones de resaltado de sintaxis.
  • No ejecutes el código fuente de las publicaciones.

Tablas:

  • Convierte tablas de Markdown, Word o HTML en tablas semánticas.
  • Envuelve las tablas anchas en el contenedor de tabla responsiva existente del sitio o añade un pequeño envoltorio local.
  • Preserva las filas de encabezado, la intención de alineación y las leyendas cuando estén disponibles.

Enlaces, índices de URL y referencias internas:

  • Preserva los enlaces externos con texto de enlace claro.
  • Convierte los enlaces relativos y los enlaces .md de Markdown a la ruta HTML estática generada cuando la publicación de destino se importa.
  • Convierte los wikilinks de Obsidian como [[Nota]], [[Nota#Encabezado]] y [[Nota|Alias]] en enlaces normales cuando el destino se pueda resolver.
  • Preserva los enlaces internos no resueltos como marcadores de posición visibles o texto plano, y repórtalos.
  • Genera IDs de encabezado estables cuando el sitio use enlaces de anclaje o tabla de contenidos.
  • Para publicaciones de índice de URL, marcadores o resúmenes de enlaces, mantén la estructura de lista. Usa el estilo de tarjeta/lista de enlaces existente del sitio cuando esté presente; no inventes tarjetas de vista previa que requieran obtener metadatos remotos a menos que el usuario lo pida.

Notas al pie, citas y referencias:

  • Convierte las notas al pie de Markdown en una sección de notas al pie usando el estilo existente del sitio si está presente.
  • Preserva las etiquetas de cita, las entradas de bibliografía y los enlaces de referencia.
  • Si el texto fuente usa claves de cita no resueltas como [@documento2024], mantenlas visibles y reporta que faltan metadatos de cita a menos que se proporcione un archivo de bibliografía.

Callouts, admoniciones y tipos de bloque:

  • Convierte los callouts estilo Obsidian/GitHub como > [!NOTA], > [!CONSEJO], > [!ADVERTENCIA] y > [!IMPORTANTE] en el patrón de callout/tarjeta/blockquote más cercano del sitio.
  • Preserva las listas de tareas como listas de verificación cuando el sitio actual tenga estilo de lista de verificación; de lo contrario, usa marcado de casilla de verificación deshabilitada o listas simples.

Incrustaciones y archivos adjuntos:

  • Para PDFs, diapositivas, conjuntos de datos, descargas, audio y video, prefiere un enlace claro o una tarjeta de descarga a menos que el sitio ya incruste ese tipo de medio.
  • Copia los archivos adjuntos locales solo cuando los proporcione el usuario.
  • Mantén las incrustaciones remotas solo cuando el usuario posea o haga referencia intencional a ellas.
  • Para bloques de diagramas Mermaid o de otro tipo, usa el renderizador existente si está presente. Si no existe ningún renderizador, preserva el bloque fuente y repórtalo, o conviértelo a un SVG/PNG estático solo cuando sea práctico y apropiado.

5. Manejar Imágenes y Activos de la Publicación

Maneja las imágenes de acuerdo con las convenciones de activos del sitio actual.

Primero inspecciona cómo las publicaciones existentes almacenan y renderizan imágenes:

  • Carpeta de activos compartida como assets/images/posts/<slug>/.
  • Activos de publicación colocalizados como posts/<slug>/images/.
  • Campos de datos como cover, heroImage, thumbnail o images.
  • Marcado de figura, leyendas, enlaces de lightbox, carga diferida, atributos de ancho/alto y clases CSS responsivas.

Prefiere el patrón existente. Si no existe ningún patrón, usa una convención estática simple como:

assets/images/posts/<slug-de-la-publicacion>/

Para fuentes Markdown:

  • Resuelve los enlaces de imagen relativos desde la carpeta del archivo Markdown.
  • Copia las imágenes locales en la carpeta de imágenes de la publicación del sitio cuando sea necesario.
  • Reescribe las referencias de imagen de Markdown a las nuevas rutas relativas del sitio.
  • Para páginas de artículo anidadas, incluye la profundidad correcta de ../ en las rutas de imagen.
  • Preserva el texto alternativo de Markdown cuando esté presente.
  • Convierte las leyendas de imagen si la fuente usa texto en cursiva cercano, atributos de título o incrustaciones estilo Obsidian.
  • No dejes enlaces apuntando a rutas de disco local absolutas.

Para notas de Obsidian:

  • Soporta incrustaciones comunes como ![[imagen.png]] y carpetas de archivos adjuntos relativos.
  • Busca carpetas de archivos adjuntos probables cerca de la nota, como attachments/, assets/, images/ o la carpeta de archivos adjuntos configurada del vault cuando sea visible.
  • Reescribe las incrustaciones en marcado de imagen HTML normal o figura.

Para fuentes de Word .docx:

  • Extrae las imágenes incrustadas del paquete del documento o usa las herramientas de documento disponibles.
  • Preserva el orden de las imágenes en relación con el texto circundante cuando sea posible.
  • Guarda las imágenes extraídas bajo la carpeta de imágenes de la publicación con nombres estables.
  • Usa leyendas cercanas o texto alternativo cuando esté disponible.

Para fuentes de HTML antiguo:

  • Descarga o copia las imágenes referenciadas desde el HTML de origen cuando sea posible y el usuario lo permita.
  • Descarta marcos de lightbox, scripts de galería y envoltorios que dependan del CSS/JS perdido del sitio antiguo. Usa el estilo de imagen simple del sitio actual.
  • Convierte imágenes de ancho completo, imágenes de fondo o sprites CSS en elementos de imagen HTML estándar cuando sea apropiado.
  • Reporta cualquier imagen que no se pueda descargar, copiar o convertir para que el usuario decida.

Para texto pegado sin imágenes:

  • No inventes imágenes de portada, capturas de pantalla o capturas.
  • Si el texto pegado contiene referencias de imagen, reporta que no se proporcionaron archivos de imagen.

6. Manejar Imágenes Especializadas y Activos para Aprendizaje Automático

Cuando una publicación de origen contenga diagramas de aprendizaje automático, resultados de entrenamiento, curvas de pérdida, matrices de confusión o visualizaciones de datos de investigación:

  • Preserva imágenes de resultados generados por herramientas comunes de ML/DL como matplotlib, seaborn, tensorboard, wandb y otros marcos de trazado.
  • Cuando las imágenes de origen se exporten como SVG o PDF vectorial, prefiere esos formatos sobre PNG para la nitidez en la documentación.
  • Convierte las tablas de resultados de entrenamiento (pérdida, precisión, puntuación F1, etc.) en tablas HTML semánticas con el estilo de tabla existente del sitio.
  • Si la publicación de origen contiene pseudocódigo para algoritmos o arquitecturas de modelos, trata los bloques de pseudocódigo como bloques de código con el resaltado de lenguaje de pseudocódigo cercano o etiquetados como texto simple.
  • Para contenido matemático relacionado con ML (gradientes, funciones de pérdida, matrices de atención, embeddings), sigue las reglas de manejo de matemáticas de la sección 4.
  • No ejecutes scripts de entrenamiento, inferencia o visualización de modelos. Extrae solo salidas estáticas.

7. Actualizar Índices, Navegación y Puntos de Entrada

Después de crear las páginas de las publicaciones, actualiza los sistemas de navegación e índice que ya existían antes de tu ejecución.

No crees nuevas páginas de índice, archivos de datos o canales RSS a menos que el sitio ya los tenga. Si el sitio no tiene un índice, informa al usuario que las publicaciones se han agregado como archivos independientes sin enlaces de navegación.

Para índices de publicaciones existentes como blog.html, archive/index.html o notes/index.html:

  • Añade enlaces a las nuevas publicaciones en la posición cronológica correcta (más reciente primero a menos que el sitio use orden ascendente).
  • Coincide con el formato de entrada existente: título, fecha, resumen, etiquetas, imagen de portada y cualquier metadato adicional que el índice muestre.
  • Si el índice está renderizado a partir de datos (por ejemplo, data/posts.json, data/blog.json, un arreglo JavaScript en línea), actualiza el archivo de datos en lugar del HTML. Después de actualizar el archivo de datos, regenera los puntos de entrada afectados cuando sea práctico o notifica al usuario que se necesita regenración.
  • Si el índice es una página HTML estática con entradas escritas a mano, añade la nueva entrada manualmente, manteniendo el orden y la plantilla visual.

Para etiquetas, categorías o páginas de archivo:

  • Añade las nuevas publicaciones a las páginas de etiquetas/categorías apropiadas si esas páginas ya existen y contienen listas de publicaciones.
  • Si las etiquetas son listas renderizadas a partir de datos, actualiza los datos subyacentes.
  • Si la publicación de origen contiene etiquetas o categorías que la página de índice de etiquetas/categorías no tiene actualmente, añade esas etiquetas/categorías de manera apropiada, y reporta al usuario las nuevas etiquetas añadidas por primera vez.
  • No generes páginas de listado de etiquetas individuales a menos que el sitio ya lo haga.

Para la sección de publicaciones recientes de la página de inicio:

  • Actualiza la lista de publicaciones recientes para incluir la nueva publicación si la página de inicio tiene una sección de este tipo.
  • Si la página de inicio muestra un número fijo de publicaciones, elimina la más antigua de la vista y añade la nueva. A menos que el usuario especifique lo contrario.
  • Coincide con el formato de visualización existente: título solo, tarjeta miniatura, resumen excerpt, enlace con fecha.

Para RSS/Atom/sitemap:

  • Si el sitio genera un feed RSS/Atom o sitemap.xml, actualiza esos archivos.
  • Si el feed se genera a partir de datos (por ejemplo, un script que lee data/posts.json), actualiza el archivo de datos y notifica al usuario que regeneren el feed.
  • Si el feed está escrito a mano o es parte de un archivo de diseño, prefiere actualizar el feed directamente o notifica al usuario que el feed necesita regeneración.

Para datos de búsqueda con búsqueda en el lado del cliente:

  • Si el sitio tiene un índice de búsqueda JSON (por ejemplo, data/search.json), añade las nuevas publicaciones a ese índice.
  • Si la búsqueda se basa en un arreglo JavaScript, actualiza ese arreglo.
  • No añadas una dependencia de búsqueda a un sitio que antes no la tenía.

Para enlaces de publicaciones relacionadas, publicaciones populares, secciones de lectura adicional:

  • Cuando estas secciones se rendericen a partir de datos (metadatos de publicaciones, campos de etiquetas, relaciones entre publicaciones), actualiza los datos subyacentes.
  • Si se generan a partir de lógica del lado del servidor (no utilizable en implementaciones estáticas típicas), omite la actualización y reporta que la función debe ser regenerada.
  • Para recomendaciones estáticas: si el sitio usa enlaces de publicaciones relacionados codificados en cada página de artículo, añade enlaces apropiados desde la nueva publicación a las publicaciones existentes y desde las publicaciones existentes afectadas a la nueva publicación, pero solo si las relaciones son recíprocas y no rompen el diseño de alguna publicación existente. Pregunta al usuario.

Para secciones "Próximamente", notas de desarrollo o listas de deseos de escritura:

  • Si la página de inicio o el archivo tiene una sección de notas de desarrollo o próximamente, no elimines esas notas a menos que el usuario pida la transición.
  • Después de una importación exitosa, pregunta al usuario si se deben eliminar las notas de próximamente correspondientes.

8. Verificar la Corrección de la Publicación Importada

Después de crear las publicaciones y actualizar los índices, verifica:

  • Las rutas son relativas a la página y no absolutas de raíz a menos que el sitio lo requiera.
  • Las imágenes se cargan desde sus nuevas ubicaciones.
  • El contenido de matemáticas se renderiza cuando se usa un renderizador.
  • Los bloques de código se muestran correctamente.
  • Las tablas no rompen el diseño de la página.
  • Los enlaces internos se resuelven cuando el destino es importado.
  • La navegación y los puntos de entrada enlazan a las nuevas publicaciones.
  • Las nuevas etiquetas o categorías son accesibles.
  • La página de inicio muestra la nueva publicación.
  • El feed RSS/Atom y el mapa del sitio incluyen la nueva publicación cuando corresponda.

Usa review-static-site para la verificación automatizada.

Si la verificación encuentra problemas:

  • Corrige las rutas, activos, enlaces o datos.
  • Vuelve a ejecutar la verificación.

Notas de Implementación

  • Los archivos de salida deben colocarse bajo el directorio raíz del sitio existente.
  • Los archivos de origen y destino residen en el mismo sistema de archivos.
  • La habilidad no debe ejecutar procesos en segundo plano ni iniciar un servidor.
  • No sobreescribas el contenido existente del usuario sin confirmación.

Individual skills in this repo

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

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 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