Communitygithub.com

construcción-de-temas-wordpress

Convierte un diseño HTML/CSS/JS estático en un tema de WordPress personalizado que el cliente pueda editar, cubriendo estructura del tema, theme.json, encolado de scripts, patrones de bloques, tipos de contenido personalizados y contenido editable.

¿Qué es construcción-de-temas-wordpress?

Esta habilidad guía a un agente de IA en la construcción de temas de WordPress a partir de diseños estáticos, priorizando que la estructura visual quede fija en código mientras el contenido es completamente editable desde el editor. Soporta tres enfoques: temas de bloques (con theme.json y plantillas HTML), híbridos clásicos (PHP con theme.json y patrones de bloques) y temas hijo. La estrategia cubre todo el flujo de conversión: congelar el diseño estático, dividirlo en partes (header, footer, secciones), externalizar los tokens de diseño a theme.json, encolar assets correctamente, y hacer editable el contenido mediante tipos de contenido personalizados, patrones de bloques, campos personalizados y menús. También incluye pautas para manejar animaciones (como GSAP) dentro de WordPress, escapar correctamente la salida, optimizar imágenes y proporcionar una lista de verificación de entrega. La habilidad está pensada para plataformas como Claude Code o Cursor, donde el agente ejecuta estos pasos de forma asistida.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/wordpress-theme-build

Preguntar en tu IA favorita

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

Documentación

Construcción de temas WordPress

El objetivo es un tema donde el diseño está fijado en código y el contenido es editable en el editor. El texto codificado directamente en las plantillas es la razón más común por la que los clientes vuelven para hacer cambios triviales.

Elegir el enfoque

EnfoqueCuándo elegirlo
Tema de bloques (theme.json, plantillas HTML)Nuevo proyecto, el cliente edita en el Editor del Sitio, el contenido es principalmente bloques estándar
Tema clásico híbrido (plantillas PHP más theme.json y patrones de bloques)Marcado personalizado complejo o animaciones pesadas que requieren control exacto del HTML
Tema hijoModificar un tema existente; nunca editar un tema padre directamente, ya que las actualizaciones lo sobrescriben

Para sitios con animaciones y diseño orientado a marketing, el enfoque híbrido suele ser el pragmático: marcado preciso en PHP, contenido editable a través de patrones, campos y el editor de bloques.

Estructura mínima

mi-tema/
├── style.css            # comentario de cabecera del tema (obligatorio)
├── functions.php        # configuración, encolados, registros
├── theme.json           # paleta, escala tipográfica, espaciado, anchos de layout
├── index.php            # plantilla de respaldo (clásico/híbrido)
├── front-page.php       # página de inicio
├── header.php  footer.php
├── template-parts/      # un archivo por sección
├── patterns/            # patrones de bloques (registrados automáticamente)
├── assets/css  assets/js  assets/media
└── screenshot.png       # 1200x900

Cabecera de style.css:

/*
Theme Name: Mi Tema
Author: Tu Nombre
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: mi-tema
*/

Flujo de conversión

  1. Congelar la construcción estática. Terminar HTML, CSS y JS primero y validarlo. Convertir un objetivo en movimiento duplica el trabajo.
  2. Dividir en partes. El encabezado y el pie van a header.php y footer.php con wp_head() y wp_footer(). Cada sección de la página de inicio se convierte en un archivo en template-parts/, cargado con get_template_part().
  3. Mover los tokens a theme.json (paleta, tamaños de fuente, espaciado, ancho de contenido) para que el editor muestre las mismas opciones que el frontend. Mantén los mismos valores que las propiedades personalizadas de CSS; WordPress genera variables --wp--preset--* que puedes alias. Si la CLI webcraft está disponible, webcraft tokens "#brand" --format theme-json -o theme.json escribe un archivo versión 3 a partir de los mismos valores que tokens.css.
  4. Encolar, nunca codificar, los assets:
add_action('wp_enqueue_scripts', function () {
    $v = wp_get_theme()->get('Version');
    $uri = get_theme_file_uri('assets');
    wp_enqueue_style('mi-tema', "$uri/css/main.css", [], $v);
    wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
    wp_enqueue_script('mi-tema', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});

Agrupa las librerías localmente en lugar de desde una CDN cuando sea posible; evita una solicitud de terceros y un problema de consentimiento. 5. Hacer editable el contenido. Elegir por sección:

  • Elementos repetitivos con sus propias páginas (servicios, portafolio, testimonios): un tipo de contenido personalizado consultado con WP_Query.
  • Texto e imágenes de secciones únicas: patrones de bloques que el cliente inserta y edita, o campos personalizados.
  • Elementos globales (teléfono, enlaces sociales, texto del pie): el Personalizador o una pequeña página de opciones.
  • Navegación: register_nav_menus() y wp_nav_menu().
  1. Escapar todo en la salida: esc_html(), esc_attr(), esc_url(), wp_kses_post() para texto enriquecido. Encierra las cadenas en __() o esc_html__() con el dominio de texto.
  2. Imágenes: usa wp_get_attachment_image() para que se generen srcset, sizes, dimensiones y carga diferida. Registra los tamaños necesarios con add_image_size().
  3. Soportes del tema: title-tag, post-thumbnails, editor-styles, responsive-embeds, html5, wp-block-styles.

Animaciones dentro de WordPress

  • Los scripts que ocultan contenido no deben ejecutarse en el editor de bloques. Encolarlos solo en el frontend (wp_enqueue_scripts, no enqueue_block_assets).
  • La barra de administración desplaza los encabezados fijos 32px (46px en móvil); compensar con body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }.
  • Los plugins de caché y optimización que difieren o combinan JS pueden romper el orden de carga. Declara las dependencias correctamente para que sean respetadas, y prueba con el plugin activado.
  • El contenido añadido en el editor no tendrá tus atributos de animación. Aplica las animaciones por clase de bloque en JS, o proporciona patrones que incluyan los atributos.

No hacer

  • Editar el núcleo de WordPress o un tema padre.
  • Poner funcionalidad que deba sobrevivir a un cambio de tema (tipos de contenido personalizados, shortcodes) en el tema cuando el cliente pueda cambiar de tema; un pequeño plugin es el lugar adecuado.
  • Hacer consultas dentro de bucles sin reiniciar (wp_reset_postdata()).
  • Entregar con avisos de WP_DEBUG. Desarrollar con WP_DEBUG activado.
  • Agrupar plugins de pago o assets cuya licencia no permita la redistribución.

Lista de verificación de entrega

  • El cliente puede cambiar cada texto visible, imagen, elemento del menú y detalle de contacto sin tocar código.
  • Página de inicio configurada en Ajustes, Lectura; enlaces permanentes configurados como nombre de entrada.
  • Favicon (icono del sitio), plantilla 404, plantilla de búsqueda, página de privacidad presentes.
  • Una guía de edición de una página con capturas de pantalla.
  • Luego ejecutar la habilidad launch-qa.

Individual skills in this repo

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

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Skills relacionados