Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Utiliza esta habilidad para convertir un sitio web estático personal generado (como blog, portafolio, jardín digital o recreación de estilo) en el sitio propio del usuario, reemplazando identidades de marcador de posición, texto de perfil, enlaces, proyectos, elementos destacados, datos de contacto, metadatos y contenido de páginas de demostración.

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

Esta habilidad permite personalizar un sitio web estático generado por otra herramienta (como `make-personal-site` o `copy-website-style`) para que parezca el sitio propio del usuario, eliminando la apariencia de plantilla, demo o copia de referencia. Está diseñada para agentes de IA como Claude Code, Cursor y Codex, y se enfoca exclusivamente en la edición de contenido y metadatos, sin modificar el diseño, la elección de tema ni la estructura del sitio. El flujo comienza con un inventario de contenido, donde se identifican campos de marcador de posición (como 'your name', 'example.com' o 'lorem ipsum') y datos de la fuente original. Luego se reemplazan sistemáticamente el título, nombre del autor, biografía, enlaces sociales, avatar, logo, metadatos y cualquier contenido heredado de la plantilla o sitio fuente. La habilidad también incluye una guía de adaptación de contenido según el estilo del sitio (minimalista, terminal, bento, blog, etc.) y una fase de validación que prioriza herramientas interactivas de navegador (como el plugin de navegador de Codex) sobre Playwright o capturas de pantalla, verificando que los cambios sean visibles y correctos en todas las páginas relevantes. Finalmente, actualiza el archivo `EDITING.md` para documentar los campos llenados y los marcadores restantes, y sugiere ejecutar `review-static-site` para una validación completa.

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

Preguntar en tu IA favorita

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

Documentación

Personalizar Sitio

Objetivo

Personalizar un sitio estático ya generado para que se sienta como el sitio propio del usuario, no como una plantilla, demo o copia de referencia.

Esta habilidad edita contenido y metadatos. No elige un tema, rediseña el diseño, recrea un sitio de referencia, migra un archivo grande de artículos, publica el sitio ni convierte el proyecto a otro framework.

Contrato

Entradas:

  • Carpeta de sitio estático existente generado, EDITING.md, mapa de páginas o notas de entrega.
  • Identidad/contenido proporcionados por el usuario: biografía, currículum, README de GitHub, página de inicio anterior, enlaces sociales, proyectos, avatar/logo, datos de contacto o reemplazos específicos.
  • Archivos de datos existentes, bloques de datos en JavaScript, metadatos y contenido de marcador de posición/fuente a reemplazar.

Salidas:

  • Contenido visible personalizado, metadatos, enlaces, imágenes y campos de identidad a nivel de fuente.
  • Residuos de plantilla/demo/sitio fuente eliminados o reemplazados.
  • EDITING.md actualizado que describe los campos completados, marcadores de posición restantes y ubicaciones de contenido.

Límites:

  • No elegir un nuevo tema, rediseñar el diseño, recrear un nuevo sitio de referencia, importar un archivo grande de escritos, publicar ni convertir frameworks.
  • No inventar datos personales específicos, empleadores, escuelas, premios, fechas, ubicaciones o métricas.
  • No pegar datos privados del usuario en el informe final innecesariamente.

Criterio de éxito:

  • La identidad/contenido proporcionados por el usuario aparecen en las ubicaciones correctas visibles en el navegador.
  • Los marcadores de posición importantes y la identidad del sitio fuente han desaparecido o están documentados intencionalmente.
  • Los enlaces y activos internos modificados siguen siendo relativos a la página y válidos.
  • review-static-site puede pasar o solo informar limitaciones aceptadas.

Si el criterio falla:

  • Re-inventariar HTML, metadatos, archivos de datos y contenido renderizado por JavaScript.
  • Reemplazar cadenas de marcador de posición/fuente omitidas.
  • Usar edit-site-part para problemas pequeños de ajuste de diseño causados por contenido nuevo.
  • Usar review-static-site nuevamente después de las correcciones.

1. Entradas

Utilizar cualquier material disponible:

  • Carpeta de sitio estático, generalmente site/, dist/, out/ o public/.
  • EDITING.md, mapa de páginas o notas de entrega de otra habilidad.
  • Biografía, currículum, CV, README de GitHub, página de inicio anterior, enlaces sociales, lista de proyectos, avatar, logo o datos de contacto proporcionados por el usuario.
  • Archivos de datos existentes como profile.json, posts.json, projects.json o bloques de datos en assets/script.js.
  • Instrucciones de reemplazo específicas del usuario.

Si falta información importante, usar marcadores de posición claros en lugar de inventar datos personales detallados.

2. Inventario de Contenido

Antes de editar, identificar dónde vive el contenido personal o de marcador de posición.

Revisar:

  • Archivos HTML y subpáginas.
  • <title>, meta descripción, metadatos de Open Graph/Twitter, referencias de favicon/logo y encabezados visibles.
  • Encabezado, navegación, héroe, secciones de perfil/acerca de, bloques de contacto, pie de página, barras laterales, tarjetas y superposiciones.
  • Contenido repetido en archivos JSON, bloques de datos JavaScript o listas HTML repetidas.
  • Páginas de demostración de artículos/detalles, páginas de proyectos, páginas de notas, páginas de enlaces y páginas especiales.
  • Instrucciones de EDITING.md y cualquier ubicación de contenido documentada.

Buscar texto común de marcador de posición o demo como tu nombre, [email protected], example.com, lorem ipsum, publicación de muestra, proyecto de muestra, TODO, reemplázame y cadenas similares.

3. Reemplazo de Identidad Personal

Reemplazar campos de identidad visibles y a nivel de fuente de manera consistente.

Campos típicos:

  • Título del sitio, nombre del autor, nombre para mostrar, rol, eslogan, biografía corta, ubicación, disponibilidad/estado e intereses.
  • Correo electrónico, enlaces sociales, GitHub, X/Twitter, LinkedIn, Bluesky, RSS, boletín, currículum/CV y otros enlaces proporcionados por el usuario.
  • Avatar, logo, favicon, texto alternativo, pies de foto de imagen y etiquetas de perfil.
  • Texto del héroe de la página de inicio, texto de la página de inicio, texto de contacto, texto del pie de página y descripciones de metadatos.

No inventar empleadores, escuelas, premios, publicaciones, métricas, ubicaciones o años específicos. Si el usuario no ha proporcionado algo, mantenerlo neutral y fácil de reemplazar.

Al reemplazar enlaces o activos, preservar la compatibilidad de rutas estáticas:

  • Mantener enlaces y activos locales del sitio relativos a la página, no absolutos a la raíz.
  • Desde páginas raíz, usar rutas como assets/avatar.png, about.html y posts/example.html.
  • Desde páginas anidadas, usar la profundidad correcta como ../assets/avatar.png y ../index.html.
  • No introducir /assets/..., /posts/..., /images/..., /data/... ni / para enlaces internos a menos que el sitio esté intencionalmente limitado a raíz del servidor y el usuario acepte que la apertura directa de archivos pueda fallar.
  • Los enlaces externos como GitHub, LinkedIn, correo electrónico y dominios personales pueden permanecer como URL absolutas.

4. Limpieza del Sitio Fuente y la Plantilla

Al personalizar una recreación de estilo, eliminar la identidad del sitio original y el contenido específico de la fuente de manera predeterminada.

Reemplazar o eliminar:

  • Nombres de autores originales, handles, dominios, correos electrónicos, enlaces sociales, ID de análisis, enlaces de amigos, URL privadas, texto de licencia, estadísticas del sitio y enlaces comunitarios.
  • Catálogo de artículos original, texto del cuerpo del artículo, nombres de proyectos, testimonios personales y afirmaciones personales.
  • Avatares, portadas, capturas de pantalla, logotipos u otros activos descargados del sitio original a menos que el usuario los posea o tenga permiso.

Mantener la estructura visual y el patrón de interacción, pero hacer que el contenido pertenezca claramente al usuario o siga siendo contenido de marcador de posición neutral.

5. Adaptación de Contenido

Adaptar el material del usuario al estilo y diseño existentes del sitio en lugar de pegar texto largo y sin formato en todas partes.

Usar el concepto del sitio para dar forma al texto:

  • Sitio minimalista: conciso, tranquilo, directo.
  • Estilo terminal/archivo: perfil, registro, estado, directorio o redacción similar a configuración.
  • Estilo bento: fragmentos modulares cortos.
  • Página de inicio de investigación: formal, precisa, orientada a proyectos/publicaciones.
  • Blog o jardín digital: temas de escritura, notas recientes, etiquetas y rutas de lectura.
  • Portafolio: trabajo seleccionado, rol, resultado, stack y enlaces.

Mantener longitudes de texto adecuadas para los contenedores existentes. Si un párrafo proporcionado por el usuario es demasiado largo para una tarjeta, resumirlo y colocar la versión completa en la página "Acerca de".

Preferir editar fuentes de datos centralizadas cuando existan. Si el contenido se repite en varios archivos, actualizar todas las copias visibles y de metadatos de manera consistente.

6. Validación

Usar una herramienta de navegador interactiva realmente disponible como primera opción para inspeccionar la vista previa local y confirmar que el contenido personalizado es realmente visible en los lugares correctos. "Disponible" significa que está expuesto en la lista de herramientas invocables del turno actual. En Codex, esto puede ser el complemento de navegador/navegador en la aplicación cuando se enruta al turno; en otros agentes, puede ser un navegador visible equivalente, una herramienta de navegación o un navegador con herramientas de desarrollo.

Si no hay ninguna herramienta de navegador interactiva invocable, no pretender que se realizó la verificación de ubicación en el navegador. Pedir al usuario que habilite o invoque la herramienta de navegador si la ubicación visual es importante; para Codex, esto puede significar enviar una solicitud que mencione explícitamente @browser. Si el usuario no redirige o el cliente no tiene dicha herramienta, recurrir a Playwright, capturas de pantalla, auditorías estáticas o verificaciones de fuente y declarar la limitación.

No recurrir de forma predeterminada a Playwright o validación solo con capturas de pantalla cuando una herramienta de navegador interactiva es realmente invocable. Usar Playwright solo como respaldo cuando no haya una herramienta de navegador interactiva invocable, cuando el usuario lo solicite explícitamente o cuando se necesite específicamente una regresión de script repetible.

Revisar las páginas que deberían mostrar la información del usuario, como inicio, acerca de/perfil, contacto, proyectos, enlaces y páginas representativas de artículos/detalles. Confirmar que el nombre, eslogan, biografía, avatar/logo, datos de contacto, enlaces sociales, nombres de proyectos y elementos destacados proporcionados por el usuario aparecen donde se espera.

También confirmar que el contenido importante de marcador de posición o la identidad del sitio fuente ya no sean visibles en el navegador. Esta es una verificación de ubicación de contenido, no una revisión completa de diseño visual.

Si la personalización cambió avatares, favicons, iconos sociales, enlaces de proyectos, enlaces de publicaciones o tarjetas basadas en datos, confirmar que las rutas modificadas funcionan desde la profundidad de la página afectada y que no se introdujeron rutas accidentales absolutas a la raíz en el sitio local.

Llamar o sugerir usar review-static-site al final.

Guía de Edición

Actualizar EDITING.md cuando exista, o crearlo si se espera que el sitio sea reutilizable.

Registrar:

  • Qué campos personales se completaron.
  • Qué contenido permanece solo como marcador de posición.
  • Dónde viven ahora el perfil, enlaces, proyectos, elementos destacados, publicaciones, imágenes y texto del tema.
  • Cualquier activo proporcionado por el usuario copiado en el sitio y dónde se referencia.
  • Cualquier contenido del sitio fuente eliminado o reemplazado intencionalmente.

Mantener la guía para futuros agentes y usuarios, no como texto de marketing dentro del sitio web.

Salida

Al finalizar, informar brevemente:

  • Qué información personal y páginas se actualizaron.
  • Qué archivos cambiaron.
  • Qué marcadores de posición o residuos específicos de la fuente permanecen, si los hay.
  • Si se ejecutó review-static-site o si se debe ejecutar a continuación.

No pegar los datos personales privados del usuario innecesariamente.

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

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