Communitygithub.com

Williampannn/crea-tu-sitio-web-con-claude-code

Un skill de Claude Code de principio a fin para construir tu propio sitio web — portafolio, página de aterrizaje o blog — según tu propio gusto. El proceso, no una plantilla.

¿Qué es crea-tu-sitio-web-con-claude-code?

Este skill proporciona un proceso estructurado para que cualquier persona, incluso sin conocimientos de código, pueda crear un sitio web personalizado (portafolio, blog o landing page) utilizando Claude Code como constructor. La premisa central es que la persona actúa como directora creativa, mientras que Claude ejecuta como el equipo técnico: andamia, escribe, estiliza, verifica y despliega. El skill cubre seis fases, desde definir el gusto y alcance (Fase 0), hasta desplegar un sitio vacío para depurar la tubería (Fase 1), codificar el lenguaje de diseño (Fase 2), llenar el contenido (Fase 3), iterar continuamente en pequeños pasos visibles (Fase 4), pulir y añadir detalles (Fase 5), y escuchar la retroalimentación real de los visitantes (Fase 6). Una regla clave domina todo: obtener un sitio real y funcional (aunque feo) primero, y luego mejorarlo en pequeños pasos. Está diseñado para plataformas como Next.js, Astro, o HTML+CSS plano, con hosts como Vercel, Netlify o Cloudflare Pages. El skill incluye prompts copiables para cada fase, tablas de decisión, y consejos para evitar trampas comunes.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add Williampannn/build-your-website-with-claude-code

Preguntar en tu IA favorita

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

Documentación

Construye tu sitio web con Claude Code

Esto es un proceso, no una plantilla. Enseña a alguien a construir un sitio web del que se sienta orgulloso — según su propio gusto, con su propio contenido, en la pila que mejor le quede — usando Claude Code como constructor. Tú pones el marco y los movimientos; ellos ponen la visión.

Todo se basa en un cambio de mentalidad: la persona es la directora, Claude es el equipo. Ellos deciden cómo debería sentirse y qué es suficientemente bueno; Claude andamia, escribe, estiliza, verifica y despliega. Tu trabajo al ejecutar este skill es extraer el gusto de ellos, convertirlo en instrucciones que Claude pueda ejecutar, tener algo en vivo rápidamente, y luego iterar.

La única regla que lo gobierna todo: consigue un sitio real, feo y en vivo primero, luego mejóralo en pequeños pasos que puedas ver. Un sitio que está en vivo el primer día e iterado 50 veces vence a una obra maestra que nunca se publica.


La mentalidad (dila en voz alta al principio)

  • Tú diriges, Claude construye. La persona nunca necesita escribir código — ni siquiera conocer las palabras. Describen sensaciones ("más cálido", "esto se siente apretado", "demasiado corporativo") y señalan; Claude traduce en píxeles.
  • Primero en vivo, bonito después. Despliega un esqueleto vacío antes de estilizar cualquier cosa, para depurar la tubería una vez, mientras no hay nada que romper.
  • Codifica el gusto en archivos. Una vez que les guste un estilo, escríbelo como un sistema de diseño que tanto ellos como Claude lean en cada sesión — eso evita que el sitio derive.
  • Pasos pequeños y visibles. Un cambio coherente a la vez; míralo; confírmalo. Los cambios grandes e invisibles son donde los sitios mueren.
  • Cierra el ciclo. Publica temprano, ponlo frente a personas reales, alimenta lo que dicen directamente de vuelta a Claude como la próxima lista de tareas.
  • Cuando estés atascado, pregúntale a Claude. Cada paso a continuación — crear cuentas, arreglar un error rojo en el terminal, una pantalla de hosting confusa — es algo que puedes devolverle a Claude, no algo que resolver solo. "Nunca he hecho esto, guíame a través" y "aquí hay una captura de pantalla de lo que veo" son las dos cosas más útiles que la persona puede decir.

Cómo usar este skill

Trabaja las fases más o menos en orden, pero no son una cascada rígida — la Fase 4 (el ciclo de iteración) es el motor que funciona continuamente debajo de las demás:

Fase 0 → 1 encuadrarlo y ponerlo en vivo · Fase 2 → 3 hacerlo tuyo y llenarlo · Fase 5 → 6 hacerlo memorable y escuchar · La Fase 4 funciona todo el tiempo.

Cada fase te da el objetivo, los movimientos, un prompt de copiar y pegar para que la persona se lo dé a Claude, y la única trampa que más a menudo lo arruina. El material más profundo está en los archivos de referencia — úsalos cuando una fase se ponga seria.

Permiso para parar. Un sitio tranquilo de una página — su nombre, una línea sobre ellos, un enlace — es un sitio web real y terminado. Si terminan después de la Fase 4, han terminado. Las Fases 5–6 son para cuando quieren más, no una barrera que deben superar.


Antes de empezar (Claude puede ayudar con todo esto)

La persona necesita cuatro cosas gratis en su lugar antes de la Fase 1. Todo esto se puede configurar pidiéndole a Claude que los guíe — no asumas que han hecho algo de esto:

  • Claude Code, instalado y abierto en una carpeta para el proyecto.
  • Node.js + npm (para la mayoría de las pilas modernas) — Claude puede verificar con node -v e instalarlo.
  • Una cuenta de GitHub (gratis) — donde vive el código y lo que el host observa.
  • Una cuenta de hosting — Vercel, Netlify o Cloudflare Pages (los niveles gratuitos son generosos; algunos piden una tarjeta incluso en el nivel gratis — sin costo para un sitio personal normal).

Si algo de esto no te es familiar, el primer prompt debería ser:

Nunca he configurado un proyecto de codificación antes. Verifica si Node, npm y git están instalados en mi máquina, y guíame a través — un paso a la vez — instalando cualquier cosa que falte y creando cuentas gratuitas de GitHub y [Vercel/Netlify]. Dime exactamente en qué hacer clic, y espera por mí en cada paso.

Inicio rápido (un sitio en vivo en una tarde)

Si la persona quiere impulso ahora:

  1. Extrae el resumen de gusto. Haz las cinco preguntas de la Fase 0; escribe las respuestas en un breve BRIEF.md. (~15 min)
  2. Andamia + despliega un esqueleto vacío. Elige una pila + un host de push-to-deploy (si no estás seguro, di Next.js + Vercel y sigue adelante), genera el iniciador con su CLI oficial, súbelo a GitHub, conecta el host, y confirma que el sitio en blanco está en vivo en una URL real. (~30 min, más la primera vez — las cuentas y conectar GitHub al host agregan ~20–30 min)
  3. Agrega el archivo de barandilla. Crea AGENTS.md diciéndole a Claude que lea la documentación del framework instalado antes de escribir código (Fase 1). (~2 min)
  4. Construye solo el hero. Una pantalla: su nombre, una línea sobre ellos, una llamada a la acción, colores del resumen. Míralo en el navegador. (~20 min)
  5. Ajusta y confirma. "haz el encabezado más grande", "fondo más cálido", confirma, sube — está en vivo. (~15 min)

Ahora tienen un sitio web real en una URL real. Todo después es mejora — la parte fácil. (Los tiempos asumen que las cuentas anteriores ya existen; la configuración inicial agrega tiempo, y eso es normal, no un fracaso).


Fase 0 — Encuadrarlo: gusto y alcance

Objetivo: poder describir, en palabras simples e imágenes, cómo debería sentirse el sitio y qué páginas necesita — antes de construir un solo componente.

Movimientos

  • Entrevista a la persona. No diseñes aún; extrae. Haz estas cinco:
    1. ¿Para quién es y qué quieres que hagan o sientan? (contratarte, comprar esto, leer tu escritura, "tómame en serio", "vean que soy divertido")
    2. Nombra el ambiente en 2–3 palabras. ("cálido y editorial", "limpio y técnico", "ruidoso y juguetón", "tranquilo y caro", "oscuro y brutalista"). Empuja por sentimientos, no por características.
    3. Muéstrame lo que amas. URLs de 2–3 sitios, y capturas de pantalla, paneles de inspiración, o cualquier imagen que capture la sensación — el gusto de la mayoría es visual, no verbal, así que deja que peguen imágenes. Y un sitio que odien. Toma la estructura y el ambiente, nunca el contenido.
    4. ¿Cuál es la única cosa que este sitio debe clavar? (la escritura, las imágenes, las muestras de trabajo, ser rápido)
    5. ¿Qué páginas/secciones necesitas realmente? Resiste la expansión del alcance — la mayoría de los sitios personales son Inicio + una o dos más.
  • Escribe las respuestas en un BRIEF.md en la raíz del repositorio — la estrella del norte que tú y Claude verifican. Si dieron imágenes, anota qué tomar de cada una.

Prompt para darle a Claude

Antes de construir cualquier cosa, entrevístame sobre el sitio web que quiero. Pregúntame, una a la vez: para quién es y qué quiero que los visitantes sientan o hagan; el ambiente en 2–3 palabras; sitios que amo (pegaré enlaces Y capturas de pantalla/imágenes de panel de inspiración — reacciona también a las imágenes) más uno que odio; la única cosa que este sitio debe clavar; y qué páginas necesito realmente. Luego escribe mis respuestas en un BRIEF.md como mi estrella del norte. No escribas ningún código del sitio aún.

La trampa: empezar a construir antes de que alguien pueda describir la sensación. Si no pueden nombrar el ambiente o mostrar una imagen de él, Claude por defecto irá a una plantilla genérica de SaaS y cada arreglo posterior luchará contra esa gravedad. Consigue la sensación — en palabras o imágenes — primero.


Fase 1 — Fundamento: consigue un sitio vacío en vivo, luego ponle barandillas

Objetivo: un sitio en blanco pero real, ya desplegado en una URL real con despliegue automático configurado — para que cada cambio posterior se publique gratis — más una barandilla que mantenga a Claude en terreno firme.

No necesitas saber cómo hacer nada de esto. Claude te da los clics y comandos exactos y espera mientras los haces. Cuando una pantalla te confunda, haz una captura de pantalla y pégala de vuelta — ese es todo el flujo de trabajo, no un fracaso.

Movimientos

  • Elige la pila y el host por adelantado (tabla abajo). Prefiere un host de las mismas personas que el framework para que los valores predeterminados funcionen. Cualquier opción está bien; la peor elección es pasar un día eligiendo.
  • Andamia con la CLI oficial del framework, no a mano.
  • Despliega la plantilla vacía primero. Súbela a GitHub, conecta el host, confirma que el sitio en blanco está en vivo antes de tocar el código — para depurar la tubería mientras nada más puede romperse.
  • Adjunta un dominio personalizado temprano si lo tienen (es la dirección real; la URL gratuita *.host.app es temporal). DNS — la configuración que apunta un nombre de dominio al sitio — puede tardar unas horas en surtir efecto, así que empieza temprano. ¿Aún no hay dominio? La URL del host es un buen lugar para comenzar; compra uno después.
  • Agrega la barandilla de verdad fundamental. Escribe un AGENTS.md (y un CLAUDE.md de una línea que solo diga @AGENTS.md) diciéndole a cualquier agente de IA que el framework instalado puede ser más nuevo que sus datos de entrenamiento, y que lea la documentación real en node_modules/<framework>/dist/docs antes de escribir código. Este único archivo evita toda una clase de errores de API alucinadas.
  • Mantén los secretos fuera de git desde el principio. Un .gitignore debe excluir archivos de entorno y salida de compilación; nunca confirmes claves de API o direcciones privadas — mantenlas en la configuración de entorno del host. Pídele a Claude que configure esto con el repositorio.
  • Escribe los hechos de despliegue que Claude no puede inferir: URL de producción, host, qué rama se despliega automáticamente, el slug exacto del repositorio, cualquier problema. Guárdalo en un archivo de notas/memoria — el dominio en vivo generalmente no es descubrible desde el código.
  • Configura la vista previa local + una verificación de salud: una configuración de ejecución (o comando dev documentado + puerto) y una verificación de una línea de que la URL local devuelve HTTP 200, para que puedas mirar antes de subir.

Tabla de decisión — elige una opción y sigue adelante

Si el sitio es…Pila predeterminada razonableHost
Un portafolio / sitio personal / currículumNext.js o AstroVercel / Netlify
Principalmente escritura / un blogAstro o Next.jsVercel / Netlify
Una sola página de aterrizaje / marketingAstro o Vite + ReactNetlify / Cloudflare Pages
Algo que quieras editar a mano como archivos planosHTML + CSS plano (sin compilación)Netlify / CF / GitHub Pages
"No sé, solo hazlo funcionar"Next.js + VercelVercel

(La última fila elige Next.js + Vercel solo porque es la ruta más documentada para que Claude se apoye — todas las opciones anteriores son igualmente legítimas.)

Prompt para darle a Claude

Andamia un sitio [Next.js / Astro / HTML+CSS plano] completamente nuevo con su herramienta oficial, mantén el iniciador intacto, luego guíame a través: git init + primer commit (con un .gitignore que excluya entorno/secretos), crear un repositorio de GitHub, y conectar [Vercel / Netlify] para que cada subida a main se despliegue automáticamente. Confirma que el sitio vacío está en vivo en una URL real antes de que escribamos cualquier código. Luego crea un AGENTS.md que le diga a cualquier agente de IA que el framework instalado puede ser más nuevo que sus datos de entrenamiento y que LEA la documentación en node_modules/[framework]/dist/docs antes de escribir código, más un CLAUDE.md que contenga solo `@AGENTS.md`. Finalmente, guarda mi URL de producción, host, rama de despliegue y repositorio en un archivo de notas. Dame los clics exactos y espera en cada paso.

La trampa: construir todo el sitio antes de desplegar una vez (entonces estás depurando código y tubería al mismo tiempo), o confiar en la memoria del modelo de un framework que cambia rápidamente en lugar de anclarlo a la documentación instalada.

→ Medios, límites de tamaño, comandos de codificación, verificación de producción: references/PLAYBOOK.md.


Fase 2 — Codifica tu lenguaje de diseño

Objetivo: un sistema de diseño escrito y legible por máquina — color, tipografía, espaciado, movimiento, voz — que tanto la persona como Claude lean cada sesión, para que cada nueva página se mantenga en la marca en lugar de derivar en cinco aspectos ligeramente diferentes.

Haz esto después de tener una página que realmente te guste, no antes. Extraes el sistema de algo bueno; no lo inventas en el vacío.

Movimientos

  • Nombra el estado de ánimo en palabras primero, luego deriva cada regla de él. Dos frases cortas; si dos estados de ánimo están en tensión, esa tensión se convierte en una regla. (Una construcción real tenía como frases "calma editorial cálida + artesanía de píxeles juguetona" — pero un sitio "tranquilo y caro" o "ruidoso y brutalista" nombraría las suyas y derivaría reglas muy diferentes).
  • Usa el color deliberada y consistentemente. Una paleta restringida — a menudo un solo acento — mantiene la jerarquía legible y es el valor predeterminado seguro. Pero si el gusto es maximalista, retro o brutalista, un sistema multicolor es una elección legítima. La regla no es "exactamente un acento"; es que cada color tiene un rol definido y se usa de la misma manera en todas partes.
  • Color como tokens con nombre de rol, no hexes esparcidos en el marcado. Expresa texto suave y bordes como un color de tinta con opacidad reducida, en lugar de inventar cinco grises casi idénticos.
  • Empareja tipografía por rol, no por tipo de letra (cuerpo/UI, encabezados/"voz", mono, display). Referencia el rol para que la fuente real pueda cambiar después sin una reescritura.
  • Fija un ritmo de espaciado y una escalera de z-index, y escribe "no inventes nuevos valores."
  • Declara una filosofía de movimiento que se ajuste al estado de ánimo: bucles ambientales baratos en CSS, retroalimentación interactiva en una librería JS; bloquea el movimiento no esencial detrás de prefers-reduced-motion.
  • Establece una línea base accesible (es parte de la calidad, no un complemento): contraste de texto del cuerpo ≥ 4.5:1, orden de encabezados real, estados de foco visibles, hitos semánticos, texto alternativo en imágenes significativas. Una paleta audaz/oscura es exactamente donde el contraste falla silenciosamente.
  • Escribe la voz y el tono como diseño — el contenido es parte del aspecto (¿minúsculas? ¿juguetón? ¿palabras simples? ¿sin relleno corporativo?).
  • Codifícalo en dos archivos confirmados: un DESIGN_SYSTEM.md en prosa (principios + recetas de componentes + una lista de verificación de construcción) y un archivo tokens (los valores brutos). Márcalo como solo hacia adelante — extraído de páginas existentes, no un objetivo de migración — para que Claude no "refactorice servicialmente" código funcional.
  • Conéctalo al contexto: referencia bo

…

[truncado para traducción]

Skills relacionados