Communitygithub.com

abanoubkhaliil/Ak-Elementor-Studio

AK Elementor Studio — creado por Abanoub Khalil (akstudio.me). Convierte CUALQUIER entrada — código HTML/CSS/JS, capturas de pantalla, imágenes (PNG, JPG, WebP), PDFs, exportaciones de Figma, maquetas, wireframes o cualquier archivo visual — en plantillas JSON de Elementor completamente estructuradas e importables a WordPress.

¿Qué es Ak-Elementor-Studio?

Esta habilidad está diseñada para desarrolladores y diseñadores que desean convertir cualquier tipo de entrada visual o de código (HTML/CSS/JS, imágenes, PDFs, maquetas de Figma) en plantillas JSON de Elementor listas para importar en WordPress. Es compatible con plataformas como Claude Code, Cursor y Codex, y sigue un proceso riguroso: primero detecta el tipo de entrada (visual, código, PDF o descripción), luego extrae colores, tipografía y diseño, y finalmente genera un JSON válido sin comentarios ni comas finales. La habilidad impone reglas estrictas: no usar el widget HTML para contenido visual (solo para scripts JavaScript), todos los IDs deben ser hexadecimales de 8 caracteres, y cada elemento debe tener su propiedad 'elements' definida. Además, realiza una entrevista previa para obtener información sobre el mapa del sitio, la versión de Elementor (Free/Pro), tipos de contenido personalizados (CPT) y el formato de salida deseado (JSON individual, ZIP nativo o Kit de plantillas de Envato).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add abanoubkhaliil/Ak-Elementor-Studio

Preguntar en tu IA favorita

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

Documentación

AK Elementor Studio

por Abanoub Khalil — Desarrollador Senior WordPress & Webflow


REGLA #1 — LA REGLA MÁS IMPORTANTE DE ESTA HABILIDAD

EL WIDGET HTML = SOLO ETIQUETAS <script> DE JAVASCRIPT.

El widget html tiene exactamente un uso válido:
  → Incrustar una etiqueta <script> para comportamiento JavaScript

Eso es TODO. Nada más va nunca en el widget html.
No encabezados. No texto. No insignias. No enlaces de navegación.
No tarjetas. No diseños. No precios. No líneas de tiempo.
No iconos. No estadísticas. No NINGÚN contenido visual.

Cada elemento visual tiene un widget nativo de Elementor. Úsalo.

REGLA #2 — REGLAS ABSOLUTAS DE JSON

1. SIN COMENTARIOS — /* */ y // ambos rompen el análisis JSON
   ❌ { /* hero */ "id": "a1b2c3d4" }    ✅ { "id": "a1b2c3d4" }

2. SIN COMAS AL FINAL
   ❌ { "a": 1, "b": 2, }               ✅ { "a": 1, "b": 2 }

3. IDs = SOLO HEXADECIMAL ÚNICO DE 8 CARACTERES
   ❌ "id": "hero_section"              ✅ "id": "a1b2c3d4"

4. CADA ELEMENTO DEBE TENER "elements": []
   ❌ { "widgetType": "heading", "settings": {} }
   ✅ { "widgetType": "heading", "settings": {}, "elements": [] }

5. REGLA isInner
   Hijos directos de "content": []        → "isInner": false
   Contenedores anidados dentro de contenedores → "isInner": true
   Widgets (dentro de cualquier contenedor)      → "isInner": false

6. SOLO COLORES HEX — nunca nombres de colores
   ❌ "background_color": "white"       ✅ "background_color": "#FFFFFF"

PASO 0 — Entrevista Pre-Vuelo

Pregunta todo en UN mensaje. Nunca lo omitas.

👋 Detalles rápidos antes de empezar:

1. MAPA DEL SITIO — ¿Páginas? (Genero un .json por página)

2. VERSIÓN DE ELEMENTOR — ¿Free o Pro?
   Pro: Theme Builder header/footer, CSS personalizado, sticky, efectos de scroll
   Free: header/footer = secciones regulares dentro de cada página

3. TIPOS DE CONTENIDO PERSONALIZADOS (CPT) — ¿Algún CPT?
   (Servicios, Portafolio, Plugins, Equipo, Testimonios → Generaré JSON de ACF)

4. FORMATO DE SALIDA
   a) Archivos .json individuales — importar uno por uno vía Templates → Saved Templates (siempre funciona, Free + Pro)
   b) ZIP de exportación nativo de Elementor — importar vía Elementor → Tools → Import Kit (sin plugin adicional)
   c) ZIP de Kit de Plantillas de Envato — requiere el plugin "Template Kit Import" instalado en WordPress
   d) .json individual + archivos de grupo de campos ACF

5. MARCA — ¿Códigos de color hex + Google Fonts?
   (O los extraigo del diseño)

PASO 1 — Detección de Entrada

EntradaPipeline
HTML/CSS/JSPipeline de Código
PNG/JPG/WebP/captura/maqueta/FigmaPipeline Visual
PDFPipeline PDF
Solo palabrasPipeline de Descripción
JSON de Elementor existentePipeline de Edición
MixtoAmbas pipelines, fusionadas

REFERENCIA COMPLETA DE WIDGETS — Widgets Nativos para Cada Elemento

Texto y Números

ElementoWidget
h1 / h2 / h3 / h4 / h5 / h6heading
Párrafo / texto del cuerpotext-editor
Contador animado (500+, 10K)counter
Barra de progreso / habilidadprogress

Acciones

ElementoWidget
Botón / CTA / enlace como botónbutton
FAQ / filas colapsablesaccordion
Navegación por pestañastabs
Alerta / banner informativoalert

Medios

ElementoWidget
Foto / imagenimage
YouTube / Vimeo / videovideo
Cuadrícula de imágenesimage-gallery
Carrusel de imágenes / sliderimage-carousel

Tarjetas y Listas

ElementoWidget
Icono + título + descripciónicon-box
Lista con viñetas e iconosicon-list
Foto + título + textoimage-box
Cita de clientetestimonial

Ayudantes de Diseño

ElementoWidget
Línea horizontal / separadordivider
Espacio vertical en blancospacer

Utilidades

ElementoWidget
Iconos de redes socialessocial-icons
Mapa incrustadogoogle-maps
Shortcode de plugin/formularioshortcode

RESOLVER ELEMENTOS COMPLEJOS SIN EL WIDGET html

Barra de Navegación

Estructura: contenedor flex (fila, space-between)
  └── widget de imagen          ← logo
  └── widget de icon-list       ← enlaces de navegación (configurar icono en "ninguno", cada elemento = un enlace de página)
      O varios widgets de botón (tamaño: xs, estilo: enlace/fantasma, uno por elemento de navegación)
  └── widget de botón           ← botón CTA

Insignia / Píldora de Estado / Etiqueta

Opción A: widget de botón
  texto: "TIEMPO COMPLETO", tamaño: "xs", border_radius: 100px
  button_text_color: "#00D4C8", button_background_color: "rgba(0,212,200,0.1)"
  sin href de enlace (o enlace a "#")

Opción B: widget de alerta
  tipo: "success" / "info" / "warning"
  alert_title: "Desarrollador WordPress"
  (estilizar con CSS personalizado si es Pro)

Línea de Tiempo Profesional / Entrada de Historial Laboral

Estructura: contenedor interno (columna, border-left: 2px solid acento)
  └── contenedor interno (fila, gap: 8px)   ← fila de fecha + estado
      └── widget de text-editor             ← "OCT 2024 — PRESENTE"
      └── widget de botón (xs, píldora)     ← insignia "TIEMPO COMPLETO"
  └── widget de heading (h3/h4)             ← "Desarrollador Senior WordPress & Webflow"
  └── widget de text-editor                 ← "InVitro Capital — Cairo, Egipto"
  └── widget de text-editor                 ← párrafo de descripción
  └── contenedor interno (fila, wrap)       ← fila de etiquetas tecnológicas
      └── widget de botón (xs, fantasma)    ← "WordPress"
      └── widget de botón (xs, fantasma)    ← "Webflow"
      └── widget de botón (xs, fantasma)    ← "CMS"

Panel de Información de Contacto

Estructura: contenedor estilizado (background: #141628, border-radius: 12px, padding: 32px)
  └── contenedor interno (fila) por fila de información:
      └── widget de text-editor    ← etiqueta "UBICACIÓN" (pequeña, atenuada)
      └── widget de text-editor    ← valor "Cairo, Egipto"
  └── contenedor interno (fila) por fila clicable:
      └── widget de text-editor    ← etiqueta "EMAIL"
      └── widget de botón          ← "[email protected]" (estilo: enlace, href: mailto:)
  └── widget de alerta             ← estado "Actualmente disponible"
  └── widget de botón              ← CTA "Reservar una llamada de descubrimiento"

Profundidad de Habilidad / Barras de Progreso

Estructura: contenedor (columna)
  └── widget de text-editor   ← encabezado "PROFUNDIDAD DE HABILIDAD"
  └── por habilidad: contenedor interno (fila)
      └── text-editor         ← etiqueta "WP"
      └── widget de progreso  ← porcentaje: 95, tipo: línea, bar_color: acento
      └── text-editor         ← etiqueta "Experto"

Tarjeta de Precios

Estructura: contenedor interno (columna, background: #141628, border-radius: 12px, padding: 40px)
  └── widget de text-editor    ← etiqueta del nivel del plan
  └── widget de heading (h2)   ← precio "$99"
  └── widget de text-editor    ← período "/mes"
  └── widget de divisor
  └── widget de icon-list      ← lista de características (iconos de verificación)
  └── widget de botón          ← CTA "Comenzar" (ancho completo)

Tarjeta de Testimonio

Usar widget de testimonio (maneja todo de forma nativa):
  image: URL del avatar, name: "Nombre del Cliente", title: "CEO, Compañía"
  content: "Texto de la cita aquí"

O diseño personalizado:
  contenedor interno (columna)
    └── widget de icon-list (1 elemento, icono de estrella × 5)  ← calificación de estrellas
    └── widget de text-editor                                     ← texto de la cita
    └── contenedor interno (fila)
        └── widget de imagen (border-radius: 50%)                 ← avatar
        └── contenedor interno (columna)
            └── widget de heading (h5)                            ← nombre
            └── widget de text-editor                             ← título/empresa

Nube de Logos / Logos de Socios

Usar widget de image-carousel:
  slides: [logo1, logo2, logo3, logo4, logo5]
  slides_to_show: 5, autoplay: sí, navigation: ninguno
  image_size: medium

Estructura de Columna de Pie de Página

Columna 1 (columna de marca):
  └── widget de imagen          ← logo
  └── widget de text-editor     ← eslogan
  └── widget de social-icons    ← LinkedIn, GitHub, Twitter

Columnas 2-4 (columnas de enlaces):
  └── widget de heading (h5)    ← "Enlaces Rápidos" / "Servicios" / "Contacto"
  └── widget de icon-list       ← enlaces (icono: ninguno o flecha, uno por enlace)

Barra inferior:
  └── contenedor (fila, space-between)
      └── text-editor           ← "© 2025 Abanoub Khalil"
      └── text-editor           ← enlaces de privacidad / términos (etiquetas <a> en línea)

Pipeline de Código

Paso 1 — Inventario

Para cada elemento: nómbralo, declara su widget nativo, explica por qué. Si consideraste el widget html, aplica primero la autocomprobación solo para JS.

Paso 2 — Asignación de Widget

Cero contenido visual en el widget html. Aplica la Referencia Completa de Widgets anterior.

Paso 3 — Extracción de CSS

Mapea CSS → ajustes de Elementor (references/style-map.md). Variables CSS → resuélvelas a hex.

Paso 4 — Construcción de JSON

Sección por sección. Valida mientras escribes.

Paso 5 — Salida

Un .json por página. Sin comentarios. Todos los IDs con hex único de 8 caracteres.


Pipeline Visual

Fase 1 — Inventario (de arriba a abajo)

BARRA DE NAVEGACIÓN:
  Logo: [posición / tipo: imagen o texto]
  Enlaces de navegación: [lista cada uno] → elementos de icon-list O widgets de botón
  Botón(es) CTA: [texto / color hex]
  Fondo: [#HEX o transparente]

HERO:
  BG: [sólido #HEX / degradado #X→#Y Ngrados / superposición de imagen / video]
  Diseño: [centrado / texto-izquierda+imagen-derecha]
  Altura mínima: [100vh / px fijo]
  Elementos:
    [¿insignia?] → widget de alerta o widget de botón (xs, píldora)
    [h1] → widget de heading
    [h3/subtítulo] → widget de heading
    [descripción] → widget de text-editor
    [botones CTA] → widgets de botón
    [imagen] → widget de imagen

SECCIÓN N:
  Propósito: [características / estadísticas / acerca de / línea de tiempo / panel de contacto / testimonios / CTA]
  Diseño: [1-col / 2-col / 3-col / 4-col]
  Fondo: [#HEX]
  Por columna: lista el widget nativo para cada elemento

PIE DE PÁGINA: [N columnas, contenido por columna]

Fase 2 — Colores

Extrae hex para: primario, secundario, acento, texto de encabezado, texto del cuerpo, atenuado, fondo claro, fondo oscuro, fondo de tarjeta, borde. → Tabla de referencia completa en references/visual-analysis.md

Fase 3 — Tipografía

Fuente de encabezado, fuente del cuerpo, fuente de etiqueta — familia, peso, tamaños escritorio/tableta/móvil.

Fase 4 — Mapeo de Diseño

Usa la cuadrícula de contenedor en references/section-patterns.md.

Fase 5 — Asignación de Widget

Aplica la Referencia Completa de Widgets. Cero widgets html para contenido visual.

Fase 6 — Espaciado

Padding de sección: 60-80px estándar, 100-120px hero. Padding de tarjeta: 24-32px. Gap: 20-30px.

Fase 7 — Resumen de Análisis + JSON

## 🔍 Análisis Visual — [Página]

**Páginas detectadas:** [lista]
**Estilo:** [Oscuro/Claro/Negrita/Mínimo]

| Token | Valor |
|---|---|
| Primario | #______ |
| Acento | #______ |
| Texto de encabezado | #______ |
| Texto del cuerpo | #______ |
| Fondo | #______ |
| Fuente de encabezado | Inter 700 |

**Mapa de widgets:**
1. Barra de navegación → image + icon-list + button
2. Hero → alert (insignia) + heading + text-editor + button + image
3. Estadísticas → N× widgets counter
4. Línea de tiempo → N× [text-editor + button (insignia) + heading + text-editor + fila de botones] por entrada
5. Panel de contacto → contenedor estilizado + filas de text-editor + enlaces de botón + alert + button
6. Pie de página → image + text-editor + social-icons + columnas de icon-list

**Widgets html utilizados:** [Lista SOLO los usos de JS de <script>. Si ninguno: "Ninguno."]

**Suposiciones:** [lista todas las aproximaciones]
**⚠️ Después de importar:** reemplazar imágenes de marcador de posición, actualizar enlaces de navegación

Pipeline PDF

PDF único → Pipeline Visual. Varias páginas → una plantilla por página. Texto seleccionable → extraer copia exacta.

Pipeline de Descripción

Pregunta el tipo de página. Aplica la Referencia de Widgets. Usa valores predeterminados: primario #1A1A2E, acento #005AFF, fuente Inter.

Pipeline de Edición

Analizar → localizar → cambiar → re-generar JSON completo válido → resumir.


Esquemas Principales

Contenedor de Sección

{
  "id": "a1b2c3d4",
  "elType": "container",
  "isInner": false,
  "settings": {
    "content_width": "full",
    "flex_direction": "column",
    "flex_align_items": "center",
    "flex_justify_content": "flex-start",
    "flex_gap": { "unit": "px", "column": "30", "row": "30", "isLinked": true },
    "padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false },
    "padding_tablet": { "unit": "px", "top": "50", "right": "30", "bottom": "50", "left": "30", "isLinked": false },
    "padding_mobile": { "unit": "px", "top": "40", "right": "20", "bottom": "40", "left": "20", "isLinked": false },
    "background_background": "classic",
    "background_color": "#FFFFFF"
  },
  "elements": []
}

Contenedor Interno (columna)

{
  "id": "b2c3d4e5",
  "elType": "container",
  "isInner": true,
  "settings": {
    "width": { "unit": "%", "size": 50 },
    "width_tablet": { "unit": "%", "size": 100 },
    "width_mobile": { "unit": "%", "size": 100 },
    "flex_direction": "column",
    "flex_align_items": "flex-start",
    "padding": { "unit": "px", "top": "20", "right": "20", "bottom": "20", "left": "20", "isLinked": true }
  },
  "elements": []
}

Widget

{
  "id": "c3d4e5f6",
  "elType": "widget",
  "widgetType": "heading",
  "isInner": false,
  "settings": {},
  "elements": []
}

CSS → Elementor (Referencia Rápida)

Tabla completa en references/style-map.md.

"padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false }
"_padding": { "unit": "px", "top": "0", "right": "0", "bottom": "20", "left": "0", "isLinked": false }
"_margin": { "unit": "px", "top": "0", "right": "auto", "bottom": "30", "left": "auto", "isLinked": false }
"typography_typography": "custom", "typography_font_family": "Inter",
"typography_font_size": { "unit": "px", "size": 48 },
"typography_font_size_tablet": { "unit": "px", "size": 36 },
"typography_font_size_mobile": { "unit": "px", "size": 24 },
"typography_font_weight": "700",
"typography_line_height": { "unit": "em", "size": 1.3 },
"typography_letter_spacing": { "unit": "px", "size": -0.5 }
"background_background": "gradient", "background_gradient_type": "linear",
"background_color": "#005AFF", "background_color_b": "#0040CC",
"background_gradient_angle": { "unit": "deg", "size": 135 }
"border_border": "solid",
"border_width": { "unit": "px", "top": "1", "right": "1", "bottom": "1", "left": "1", "isLinked": true },
"border_color": "#E5E7EB",
"border_radius": { "unit": "px", "top": "12", "right": "12", "bottom": "12", "left": "12", "isLinked": true }
"box_shadow_box_shadow_type": "yes",
"box_shadow_box_shadow": { "horizontal": 0, "vertical": 4, "blur": 24, "spread": 0, "color": "rgba(0,0,0,0.08)" }

Restricciones y Notas Técnicas

  1. Solo JSON: Toda la salida debe ser JSON de Elementor válido. Sin HTML, shortcodes o scripts fuera de los widgets html dedicados.
  2. Sin contenido visual en html widget: El widget html está estrictamente limitado a para comportamiento JavaScript. No se permiten estilos, diseños ni elementos visuales.
  3. IDs únicos: Cada elemento del JSON requiere un ID hexadecimal único de 8 caracteres. Sin repeticiones.
  4. Propiedad elements: Cada sección, contenedor y widget debe incluir una propiedad "elements": [], incluso si está vacía.
  5. Anidamiento isInner: Usa "isInner": true para contenedores anidados dentro de otros contenedores; false para hijos directos de "content" y widgets.
  6. Colores: Siempre códigos hex (ej., #FFFFFF), nunca nombres de colores.
  7. Mapeo de CSS: Las variables CSS deben resolverse a valores hex explícitos. Los estilos en línea se mapean a los ajustes correspondientes de Elementor.
  8. Sin comentarios: El JSON no debe contener ningún comentario (/* */ o //).
  9. Sin comas finales: Las comas finales en objetos o arrays JSON no están permitidas.
  10. Formato de salida: La salida predeterminada es archivos .json individuales para cada página (sección). Opcionalmente, se puede generar un ZIP de exportación nativa de Elementor o un ZIP de Kit de Plantillas de Envato.

Ejemplo de Salida (Resumido)

[
  {
    "id": "a1b2c3d4",
    "elType": "container",
    "isInner": false,
    "settings": {
      "content_width": "full",
      "flex_direction": "column",
      "flex_align_items": "center",
      "flex_justify_content": "flex-start",
      "flex_gap": { "unit": "px", "column": "30", "row": "30", "isLinked": true },
      "padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false },
      "padding_tablet": { "unit": "px", "top": "50", "right": "30", "bottom": "50", "left": "30", "isLinked": false },
      "padding_mobile": { "unit": "px", "top": "40", "right": "20", "bottom": "40", "left": "20", "isLinked": false },
      "background_background": "classic",
      "background_color": "#141628"
    },
    "elements": [
      {
        "id": "b2c3d4e5",
        "elType": "container",
        "isInner": true,
        "settings": {
          "width": { "unit": "%", "size": 50 },
          "width_tablet": { "unit": "%", "size": 100 },
          "width_mobile": { "unit": "%", "size": 100 },
          "flex_direction": "column",
          "flex_align_items": "flex-start",
          "padding": { "unit": "px", "top": "20", "right": "20", "bottom": "20", "left": "20", "isLinked": true }
        },
        "elements": [
          {
            "id": "c3d4e5f6",
            "elType": "widget",
            "widgetType": "heading",
            "isInner": false,
            "settings": {
              "title": "Título de la Sección",
              "header_size": "h2",
              "typography_typography": "custom",
              "typography_font_family": "Inter",
              "typography_font_size": { "unit": "px", "size": 48 },
              "typography_font_weight": "700",
              "text_color": "#FFFFFF"
            },
            "elements": []
          }
        ]
      }
    ]
  }
]

Skills relacionados