Communitygithub.com

Gyschuaner/from-idea-to-personal-site

Utiliza esta habilidad para realizar ediciones enfocadas y de alcance reducido en un sitio web estático generado, como un blog personal, portafolio, jardín digital o recreación de estilo. Úsala cuando el usuario quiera ajustar una sección, componente, detalle visual, bloque de texto, problema responsivo o interacción ligera sin reconstruir todo el sitio.

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

Esta habilidad está diseñada para realizar mejoras iterativas y localizadas en sitios web estáticos existentes, permitiendo ajustes precisos sin regenerar el sitio completo. Es ideal para tareas como modificar un bloque hero, un layout de tarjetas, la barra lateral, el pie de página, botones, menús móviles, espaciado, colores, tipografía, intensidad de animaciones o pequeños fragmentos de texto visible. La habilidad se apoya en un flujo de trabajo que incluye la confirmación visual del área objetivo mediante herramientas de navegador interactivas, la lectura del archivo `EDITING.md` y la inspección de archivos HTML/CSS/JS relevantes. Respeta estrictamente los límites del sitio: no reconstruye páginas completas, no modifica temas globales ni introduce dependencias o rutas absolutas. Su validación se centra en la superficie afectada, utilizando herramientas de navegador reales cuando están disponibles, y recurriendo a Playwright o capturas de pantalla solo como alternativa. Es compatible con agentes como Claude Code, Cursor y Codex, y ofrece un enfoque cuidadoso y minimalista para el pulido de sitios web personales.

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

Preguntar en tu IA favorita

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

Documentación

Editar Parte del Sitio

Objetivo

Realizar una mejora dirigida a una parte de un sitio estático existente mientras se preserva el resto del sitio.

Esta habilidad es para el pulido iterativo después de que el sitio ya existe. Debe sentirse como una edición local cuidadosa, no como un nuevo pase de generación.

Contrato

Entradas:

  • Carpeta del sitio estático existente, página objetivo, captura de pantalla/URL local, o descripción en lenguaje natural de la región objetivo.
  • EDITING.md y archivos HTML/CSS/JS relevantes.
  • Cambio deseado de texto antes/después, estilo, comportamiento responsivo o interacción pequeña.

Salidas:

  • Una edición enfocada en la sección de página, componente, bloque de texto, regla de estilo o interacción ligera afectada.
  • EDITING.md actualizado solo cuando las instrucciones de edición futuras necesiten cambiar.
  • Breve informe de dónde se realizó el cambio, archivos modificados y validación ejecutada.

Límites:

  • No reconstruir todo el sitio, cambiar la dirección del tema, importar publicaciones, personalizar muchos campos, ni publicar.
  • No tocar páginas/recursos no relacionados.
  • No introducir dependencias, pasos de compilación ni rutas absolutas locales del sitio.

Criterio de éxito:

  • El cambio local solicitado es visible en la misma región del navegador que se confirmó antes de editar.
  • Las comprobaciones de escritorio/móvil o interacción pasan para la superficie afectada.
  • No se introdujeron cambios no relacionados en el diseño o la navegación.

Si el criterio falla:

  • Re-mapear la región del navegador al código fuente y realizar la corrección más pequeña posible.
  • Ejecutar o sugerir review-static-site cuando el problema afecte a la navegación compartida, muchas páginas, recursos, codificación o preparación para publicación.

Cuándo Usar

Usa esta habilidad cuando el usuario pida:

  • Cambiar una sección, tarjeta, bloque, componente o región de página.
  • Hacer un detalle visual más pequeño, más tranquilo, más denso, más limpio, más divertido, más técnico o menos distractor.
  • Corregir un problema de diseño móvil, desbordamiento de texto, problema de espaciado o alineación incómoda.
  • Ajustar una interacción pequeña como hover, alternancia de tema, comportamiento de menú, botón de copia, filtro, pestaña o animación.
  • Reescribir o acortar un fragmento específico de texto visible.
  • Coincidir con una captura de pantalla o comentario del usuario para un área localizada.

No uses esta habilidad para generación de sitios completos, búsqueda de temas, recreación cercana de un nuevo sitio de referencia, reemplazo grande de contenido personal, migración de artículos, despliegue o conversión de framework.

Entradas

Usa lo que el usuario proporcione:

  • Carpeta raíz del sitio y página objetivo.
  • Una captura de pantalla, vista del navegador, URL local o descripción en lenguaje natural del problema.
  • El texto exacto, nombre de sección, nombre de clase o área visual a cambiar.
  • EDITING.md, si está presente.
  • Archivos HTML/CSS/JS existentes.
  • Cualquier dirección de estilo o redacción deseada antes/después.

Si el área objetivo es ambigua, inspecciona el sitio y haz la interpretación razonable más pequeña. Pide una breve aclaración solo cuando múltiples ediciones plausibles producirían resultados muy diferentes.

Flujo de Trabajo

  1. Antes de editar, usa el navegador para confirmar la página objetivo y la región objetivo.
  2. Lee EDITING.md cuando esté presente, luego inspecciona los archivos HTML/CSS/JS relevantes.
  3. Usa la búsqueda para encontrar texto visible, IDs, clases, bloques de datos o marcado similar a componentes.
  4. Mapea la región del navegador confirmada a los archivos fuente relevantes, selectores, bloques de datos o manejadores de eventos.
  5. Realiza la edición coherente más pequeña que satisfaga la solicitud.
  6. Mantén el lenguaje de diseño existente a menos que el usuario pida explícitamente cambiarlo.
  7. Después de editar, regresa a la misma página y región en el navegador y verifica el cambio allí.
  8. Informa qué cambió y menciona cualquier validación de seguimiento necesaria.

Control de Alcance

Mantén la edición local.

  • Prefiere editar la sección, clase u objeto de datos existente en lugar de crear un duplicado paralelo.
  • Evita reescribir toda la página cuando un cambio a nivel de sección es suficiente.
  • Evita cambiar variables CSS compartidas a menos que el usuario quiera un cambio de estilo en todo el sitio.
  • Evita tocar páginas, recursos o contenido no relacionados.
  • Preserva la navegación, el mapa de páginas, la estrategia de marcadores de posición y las convenciones de EDITING.md.
  • Preserva la estrategia de rutas del sitio; no introduzcas rutas absolutas locales del sitio como /assets/..., /posts/..., /images/... o /data/... durante una edición local.
  • Si una solicitud pequeña expone un problema estructural más grande, explica la compensación antes de hacer cambios amplios.

Cuando el usuario pida un cambio visual amplio en múltiples páginas, sugiere usar una habilidad de generación mayor o rediseño en lugar de estirar esta.

Localizar el Lugar Correcto

Usa una búsqueda en capas:

  1. Busca el texto visible o las etiquetas cercanas.
  2. Busca en EDITING.md el mapa de sección/página.
  3. Inspecciona los enlaces de navegación y los nombres de archivos de página.
  4. Inspecciona etiquetas semánticas como header, main, section, article, aside y footer.
  5. Inspecciona selectores CSS y ganchos de eventos JavaScript.
  6. Usa herramientas de desarrollo del navegador o capturas de pantalla cuando la ubicación en el código fuente no sea obvia.

Si el contenido repetido se renderiza a partir de datos, edita los datos fuente en lugar de solo el marcado generado.

Preservación del Diseño

Adapta la edición al sitio actual.

  • Reutiliza el espaciado, la tipografía, los colores, los bordes, las sombras, los iconos y los patrones de movimiento existentes.
  • Mantén el texto dentro de su contenedor tanto en escritorio como en móvil.
  • Evita que los efectos decorativos interfieran con la lectura.
  • Respeta prefers-reduced-motion al cambiar animaciones.
  • Mantén las páginas de artículos/detalle más tranquilas que las páginas de inicio muy estilizadas, a menos que el usuario pida lo contrario.
  • No agregues un hero de estilo de marketing ni una sección decorativa no relacionada a un sitio web o blog personal.

Al cambiar texto, iguala la voz existente y el idioma del usuario.

Ediciones de Interacción

Para cambios en JavaScript o interacción:

  • Encuentra los event listeners y las convenciones de estado existentes antes de agregar nuevos.
  • Mantén JavaScript vainilla si el sitio es estático simple.
  • Evita introducir dependencias o pasos de compilación.
  • Al generar enlaces, resultados de búsqueda, URLs de imágenes o elementos de navegación en JavaScript, usa rutas relativas a la página que funcionen desde la profundidad de la página afectada.
  • Prueba los estados de clic, teclado, móvil y uso repetido cuando sea relevante.
  • Preserva los fundamentos de accesibilidad como el foco, las etiquetas y el comportamiento de movimiento reducido.

Correcciones Responsivas

Para problemas de diseño o móviles:

  • Verifica tanto el ancho de escritorio como el móvil.
  • Prefiere cambios CSS que preserven el diseño de escritorio mientras corrigen pantallas estrechas.
  • Usa dimensiones estables, ajuste de línea, anchos mínimos/máximos, ajustes de grid/flex y control de desbordamiento.
  • No ocultes contenido importante en móvil solo para que el diseño encaje.

Guía de Edición

Si el cambio afecta cómo se deben realizar ediciones futuras, actualiza EDITING.md.

Actualízalo cuando:

  • Se introduzca una nueva sección, clase, campo de datos o patrón de interacción.
  • El almacenamiento de contenido se mueva a un nuevo archivo u objeto de datos.
  • El usuario haya solicitado un cambio que los agentes futuros deban preservar.

No actualices EDITING.md para cambios pequeños de texto o espaciado a menos que la guía se vuelva engañosa.

Validación

Valida la superficie afectada, no necesariamente todo el sitio.

Usa una herramienta de navegador interactiva realmente disponible antes de editar para confirmar la página objetivo y la región. "Disponible" significa que está expuesta en la lista de herramientas invocables del turno actual. En Codex puede ser el plugin Browser/in-app browser cuando se enruta al turno; en otros agentes puede ser un navegador visible equivalente, una herramienta de browser-use o un navegador basado en devtools. Después de editar, regresa a esa misma página y región en el navegador interactivo para verificar el resultado.

Si no hay una herramienta de navegador interactivo invocable, no finjas que ocurrió la confirmación antes/después del navegador. Pide al usuario que habilite o invoque la herramienta de navegador si la edición depende del mapeo visual de la región; para Codex, eso puede significar enviar una solicitud que mencione explícitamente @browser. Si el usuario no redirige o el cliente no tiene tal herramienta, recurre a Playwright, capturas de pantalla o inspección del código fuente y declara la limitación.

No recurras por defecto a Playwright, validación solo con capturas de pantalla o inspección del código fuente cuando una herramienta de navegador interactivo sea realmente invocable. Usa Playwright solo como alternativa cuando no haya una herramienta de navegador interactivo invocable, cuando el usuario lo pida explícitamente o cuando se necesite específicamente una regresión scripteada repetible.

Para ediciones visuales, responsivas o interactivas, verifica la región cambiada en las vistas de escritorio/móvil relevantes y ejercita la interacción modificada.

Ejecuta o sugiere review-static-site solo cuando la edición afecte a la navegación compartida, el diseño global, muchas páginas, rutas de recursos, codificación de fuente o preparación para publicación.

Si la edición toca href, src, url(...) de CSS, imágenes, fuentes, favicons, archivos de datos o URLs generadas por JavaScript, verifica que la página afectada aún funcione con rutas relativas a la página y que abrir directamente el archivo estático no pierda CSS, JS o imágenes.

Salida

Para ediciones locales, solo informa:

  • Dónde se realizó el cambio.
  • Qué archivos cambiaron.
  • Qué validación se realizó.

Menciona la validación más amplia de review-static-site solo cuando realmente se recomiende. No repitas el informe ni sobre-expliques todo el código base.

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