Communitygithub.com

generar-maqueta-apple-notes

Genera capturas de pantalla de Apple Notes (iPhone, modo claro) con precisión de píxeles a partir de una especificación JSON. Produce HTML + PNG en la resolución nativa 1180×2556 del iPhone 16/15 Pro.

¿Qué es generar-maqueta-apple-notes?

Esta habilidad es un renderizador determinista que transforma una especificación JSON de una nota en una imagen PNG de pantalla de Apple Notes, con calidad de píxeles e idéntica a la de un iPhone real en modo claro. Está diseñada para ser utilizada por agentes orquestadores, como el que impulsa la habilidad 'create-apple-notes-video-ad', para generar fotograma a fotograma animaciones de escritura sobre una nota. También funciona como herramienta independiente para crear imágenes estáticas de notas rápidas ('noted to self') en anuncios, publicaciones en redes sociales o storyboards. La habilidad maneja todos los detalles visuales: barra de estado con hora y batería, píldora flotante de la barra de herramientas, título en negrita, texto del cuerpo con interlineado, cursor amarillo, subrayado de autocorrección, imágenes opcionales, listas de verificación y un teclado iOS opcional. Es importante destacar que no utiliza un modelo de lenguaje grande (LLM); es completamente determinista. El agente orquestador es responsable de redactar el contenido y de componer el JSON de la nota. Esta habilidad se ejecuta mediante línea de comandos con Node.js y Playwright, y es compatible con macOS, Linux y Windows.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gooseworks-ai/goose-skills/tree/HEAD/skills/ads/packs/video-ad-formats/create-apple-notes-mockup

Preguntar en tu IA favorita

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

Documentación

¿Qué hace generar-maqueta-apple-notes?

Genera pantallas de Apple Notes que parecen capturas de pantalla de iPhone reales: barra de estado correcta, píldora flotante de la barra de herramientas, título en negrita, texto del cuerpo con espacio entre párrafos, cursor de texto amarillo, subrayado de autocorrección, imágenes incrustadas opcionales y listas de verificación, y un teclado iOS opcional.

Propósito

Convierte una especificación JSON de nota en una captura de pantalla de Apple Notes (iPhone, modo claro) con precisión de píxeles — HTML + PNG en la resolución nativa 1180×2556 (DPR 2). Es el renderizador determinista (sin LLM) que la molécula create-apple-notes-video-ad utiliza fotograma a fotograma para simular una animación de escritura, y una herramienta independiente para crear imágenes de notas rápidas ('noted to self') en anuncios, publicaciones en redes sociales y storyboards. El agente orquestador es dueño del texto; este átomo es dueño de la fidelidad visual (barra de estado, puntuación inteligente, cursor, subrayado de autocorrección, barra de herramientas, teclado).

Cuándo usarlo

  • Necesitas una captura de pantalla falsa de Apple Notes para un anuncio, publicación en redes sociales, escena de video o maqueta de producto.
  • Necesitas una secuencia de fotogramas de Apple Notes (solo título → agregar párrafos → mover cursor) para impulsar un video de animación de escritura — utilizado por create-apple-notes-video-ad.
  • Necesitas una imagen estática de una nota rápida ('noted to self') en un storyboard.

Si estás renderizando un hilo de iMessage, usa skills/atoms/messaging/create-imessage-mockup.

Entradas

La habilidad es determinista — no incorpora un LLM. El agente orquestador compone un JSON de nota que coincide con el esquema siguiente y luego invoca el renderizador.

Esquema JSON de la nota

{
  "title": "Hola",
  "body": [
    { "type": "paragraph", "text": "Esta es una grabación de pantalla de mí escribiendo en la aplicación de notas de Apple." },
    { "type": "paragraph", "text": "Veamos cómo se siente esto." }
  ],
  "cursor": "end",
  "autocorrect_underline": ["esta", "cómo"],
  "status_bar": {
    "time": "9:41",
    "battery_pct": 87,
    "battery_low": false,
    "show_focus_glyph": false
  },
  "show_keyboard": false,
  "keyboard_state": {
    "suggestions": ["ver", "ir", "hacer"],
    "shift": "lower",
    "letters_row1": "qwertyuiop",
    "letters_row2": "asdfghjkl",
    "letters_row3": "zxcvbnm"
  },
  "with_iphone_frame": false
}
  • title — cadena. Título de visualización en negrita, una sola línea.
  • body[] — lista de bloques. Tipos de bloque compatibles:
    • paragraph — { "text": "..." }. La puntuación inteligente se aplica automáticamente (' → ', " → ", ... → …, -- → –, --- → —).
    • image — { "src": "<ruta|url>", "caption": "opcional" }. Las rutas relativas se resuelven con respecto al directorio del archivo de especificación y se incrustan como data URIs.
    • checklist — { "items": [{ "text": "...", "checked": true|false }] }. Los elementos marcados obtienen círculos rellenos amarillos con tachado; los no marcados obtienen círculos con contorno gris.
    • divider — regla horizontal.
  • cursor — "title" | "end" | null. "title" coloca el cursor amarillo al final del título; "end" lo coloca al final del último párrafo; null lo oculta.
  • autocorrect_underline[] — lista de palabras con mayúsculas exactas. Cada ocurrencia obtiene el subrayado amarillo de escritura intermedia de Apple Notes (<span class="spell">).
  • status_bar — time, battery_pct (0–100), battery_low (color de batería rojo), show_focus_glyph (icono de DND/coche al lado de la hora). La Isla Dinámica no se renderiza.
  • show_keyboard — true superpone el teclado QWERTY de iOS + la barra de herramientas de formato.
  • keyboard_state — solo se consulta cuando show_keyboard es true. shift = "lower" | "upper".
  • with_iphone_frame — agrega un bisel oscuro delgado (para composiciones destacadas).

CLI

node render.js --note examples/medio.json
node render.js --note examples/largo.json --output ./mis-exportes/ --name nota-de-hoy
node render.js --note mi-nota.json --with-keyboard
node render.js --note mi-nota.json --viewport 1080x1920   # tamaño de entrega de anuncio 9:16

Banderas

BanderaEfecto
--note <ruta>(requerido) Archivo JSON que coincide con el esquema anterior
--with-keyboardfuerza la habilitación de show_keyboard (anula la especificación)
--with-iphone-framefuerza el bisel de hardware
--no-framefuerza la desactivación del bisel de hardware
--output <dir>directorio padre para la carpeta de salida con fecha; por defecto ./apple-notes-mockup-exports/
--name <slug>anula el slug de la carpeta de salida
--out-html <ruta> / --out-png <ruta>escribe directamente en rutas explícitas (omite la carpeta con fecha)
--viewport WxHanula el viewport de renderizado (por defecto 1180x2556)
--dpr Nrelación de píxeles del dispositivo (por defecto 2)

Salida

<salida>/<YYYY-MM-DD>-<slug>/
  index.html       # HTML completo independiente (imágenes incrustadas como data URIs)
  screenshot.png   # PNG renderizado en el viewport elegido × DPR
  spec.json        # copia de la entrada para reproducibilidad

La <salida> predeterminada es ./apple-notes-mockup-exports/ en el directorio de trabajo actual.

Flujo de trabajo

  1. Recibe un prompt o un JSON de nota existente.
  2. Si solo se dio un prompt: compone un note.json que coincida con el esquema, guárdalo.
  3. Ejecuta node render.js --note <ruta> [--with-keyboard].
  4. Abre el PNG resultante para verificar el diseño. Si algo se ve mal (salto de línea incorrecto, posición del cursor incorrecta, color de batería incorrecto), edita el JSON y vuelve a renderizar.

Configuración (única vez)

cd create-apple-notes-mockup
npm install
npx playwright install chromium

Se incluye un enlace simbólico a create-imessage-mockup/node_modules en el repositorio, por lo que en un clon nuevo npm install solo es necesario si deseas que esta habilidad sea autónoma.

Archivos

ArchivoPropósito
render.jsPunto de entrada CLI — analiza banderas, resuelve rutas de imágenes, genera HTML, toma captura de pantalla
generate.jsJSON de nota → página HTML independiente (la puntuación inteligente y el subrayado de autocorrección se aplican aquí)
screenshot.jsHTML → PNG a través de Playwright (chromium headless) a 1180×2556, DPR 2
templates/note.cssTodos los estilos visuales (barra de estado, barra de herramientas, cuerpo, lista de verificación, imagen, teclado)
templates/icons.jsIconos SVG incrustados (chevron de retroceso, deshacer, compartir, más, check de hecho, señal, wifi, batería, iconos de barra de herramientas de formato, glifos de teclado)
assets/samples/sample-landscape.jpgImagen de muestra utilizada por examples/with-image.json
examples/*.json6 notas de referencia que cubren todas las variaciones (solo título, escritura intermedia, párrafo largo múltiple, con lista de verificación, con imagen, fotograma-1 teclado en minúsculas)
tests/run-all.shRenderiza cada ejemplo en tests/output/ para revisión visual
apple-notes-skill-build.htmlTablero de revisión lado a lado que compara fotogramas de video de referencia con PNG generados

Controles de calidad

Antes de declarar una nota como lista para usar:

  • El título se renderiza como título de visualización en negrita, no con peso regular.
  • El texto del cuerpo usa la puntuación inteligente de Apple: ' es curvada, " es curvada, … es un solo carácter.
  • El cursor amarillo (#FFCC00) se coloca al final del texto de destino, de ~5px de ancho.
  • Los párrafos del cuerpo están separados por una línea visual vacía (sin <br> manual).
  • Los subrayados de autocorrección son líneas amarillas cortas debajo del token marcado, con coincidencia sensible a mayúsculas.
  • Barra de estado: hora a la izquierda, señal/wifi/batería a la derecha. La batería es roja solo si battery_low: true. Sin Isla Dinámica.
  • Máscara de desplazamiento: la barra de estado y la barra de herramientas tienen fondos blancos opacos para que el contenido del cuerpo desplazado por el controlador de la molécula no se vea a través. Verifica traduciendo .note en -300px en DevTools y confirmando que el título está completamente enmascarado por la barra de herramientas, no visible detrás/de ella.
  • Barra de herramientas: píldora flotante de chevron de retroceso (izquierda), cápsula blanca con deshacer/compartir/más, círculo amarillo de Hecho (derecha). Todos proyectan sombras suaves.
  • Teclado (cuando está habilitado): diseño QWERTY que coincide con las mayúsculas de shift, tira de sugerencias muestra 3 palabras, píldora de barra de herramientas de formato sobre las teclas, micrófono + globo en la parte inferior.
  • Los bloques de imagen se renderizan con esquinas redondeadas (~18px) y respetan el padding izquierdo del cuerpo.
  • Lista de verificación: círculos rellenos amarillos + tachado en elementos marcados; círculos de contorno gris en caso contrario.

Modos de fallo

SíntomaCausaSolución
El texto del cuerpo se divide una palabra demasiado pronto o demasiado tardeEl ancho de la fuente difiere de la referencia (Chromium eligió una fuente alternativa que no es SF)Ajusta font-size en .note-body en pasos de 2px, o ensancha .note reduciendo el padding izquierdo/derecho
El título se ve delgado / no lo suficientemente negritaEl host no tiene SF Pro Display; el sistema recurre a una cara más claraEstablece font-weight: 900 (ya es el predeterminado) y verifica `fc-list
Los "Hello's", "Let's" se renderizan con comillas rectasEl preprocesador de puntuación inteligente está deshabilitadoVerifica que se llame a smartQuotes() en generate.js antes de escapeHtml
La imagen no se renderiza (espacio en blanco)URL remota bloqueada o ruta relativa no se resolvióUsa una ruta de archivo local; render.js incrusta imágenes locales como base64
El subrayado de autocorrección también coincide con "Esta" cuando solo se pretendía "esta"La expresión regular no distinguía mayúsculas de minúsculasLa expresión regular distingue mayúsculas de minúsculas de forma predeterminada. Pasa cadenas con mayúsculas exactas en autocorrect_underline
El párrafo vacío colapsa (sin espacio para el cursor)<p class="note-paragraph"></p> sin contenido tiene altura ceroEl CSS establece margin: 0 0 84px 0 por lo que un párrafo vacío aún ocupa un espacio de párrafo; asegúrate de no haber eliminado el margen inferior
El círculo amarillo de Hecho se ve naranjaDesviación del color CSSEl amarillo puro de Apple es #FFCC00. El cursor y Hecho comparten el valor; no lo cambies a #FFC107 (ámbar de Material)
La sugerencia del teclado "Hello's" se renderiza con apóstrofe rectoLas comillas inteligentes no se aplican a las sugerenciasConfirmado que se aplica mediante smartQuotes(s) en generate.js

Referencia

La especificación visual se extrajo de apple-notes-typing.MP4 (una grabación de pantalla de iPhone de 36 segundos escribiendo en Apple Notes en modo claro). Consulta apple-notes-skill-build.html en esta carpeta para ver la prueba lado a lado: cada ejemplo se muestra junto con el fotograma de referencia al que se dirige.

Individual skills in this repo

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

gooseworks-ai/goose-skills

Burned-in captions for a finished vertical video, three kinds. transcribe.py gets word timings from the video's own audio through the GooseWorks proxy (fal Whisper, bills the Ads agent, cents); captions.py burns one to three words at a time with Pillow + ffmpeg (no libass needed), either pinned to a split-screen seam (plate 25% above / 75% below) or at a fixed height, in a plate, outline or one-word serif style, with an optional red hook card; plates.py burns per-beat caption blocks (black, one union silhouette, placed in the emptiest band) for formats with no voice. The last caption (the CTA) holds to the final frame. Use as the last step of any video ad.

gooseworks-ai/goose-skills

Assemble a cartoon / animated / hand-crafted music-video ad from a config — a sung song carries the whole narrative while N per-bar i2v clips (one recurring animated character, one look pack) are each cut to their BAR window from librosa beat-tracking and hard-concatenated on the bar, VEED-whisper white bold-sans captions in the BOTTOM third (Alignment 2, above the logo bug, no pill) burned from the song's word timings re-spelled against the locked lyrics, a persistent brand logo bug held over the body (suppressed on the end card), and closed on a solid-brand-color PIL end card with the song still playing under it — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-bar + hard concat + logo bug + captions + end card + song mux); the song, character, keyframes, and clips come from create-music-elevenlabs / create-image-fal / create-video-fal. Use for the cartoon-music-video format.

gooseworks-ai/goose-skills

Assemble a cinematic live-action-style music-video ad from a config — an original sung anthem carries the whole narrative while N 35mm-film-look i2v clips are each cut to their lyric window and hard-concatenated on the beat as a 3-act arc, the anthem muxed at loudnorm I=-14, cinematic lower-third serif captions built from the song's OWN word timings (never Whisper) with the hook line landing on the chorus drop, and closed on a brand end card composited from the real asset — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-window + hard concat + anthem mux + captions + end card); the anthem, keyframes, and clips come from create-music-elevenlabs / create-image-gpt-image-fal / create-video-fal. Use for the cinematic-music-video format.

gooseworks-ai/goose-skills

Assemble an editorial-motion podcast-clip ad from a config — a real clipped podcast MP3 carries the narrative while N flat limited-palette editorial-illustration keyframes (one look pack) are animated NOT by generative i2v but by DETERMINISTIC ffmpeg ken-burns (zoompan) + hard cuts (no crossfades, which expose geometric drift), each beat snapped to its spoken line, the real audio muxed, Whisper-driven captions burned only mid-sentence, and closed on a PIL brand end card — never AI-rendered text. This is the FREE deterministic assembly stage (ffmpeg ken-burns + hard concat + audio mux + captions + end card); the real audio is clipped from source and the keyframes come from create-image-fal. Use for the editorial-motion-podcast format.

gooseworks-ai/goose-skills

Analyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.

gooseworks-ai/goose-skills

Generate a single 4-15s vertical video clip with ByteDance Seedance 2.0 reference-to-video via fal.ai. Multi-image reference (avatar + product + setting), native lip-synced VO + ambient audio (generate-audio on by default), internal multi-cut handling within one render. Routes through the GooseWorks FAL proxy (bills the Ads agent). The default clip atom for AI-creator UGC ads built on the NB2 + Seedance architecture. Validated on beauty-by-earth/video-01.

gooseworks-ai/goose-skills

Mandatory pre-publish review gate for a UGC video render. Transcribes the finished render's AUDIO with Whisper and word-diffs it against the approved spoken script, then gates set_final_render — blocking a render whose generated audio mis-voices a word (e.g. the approved "human-vetted" spoken as "human witted"), drops an approved phrase, or comes back silent. Runnable, gating counterpart to content-goose's review-transcript-integrity atom. Every ugc-video-formats recipe runs this after render and BEFORE set_final_render.

gooseworks-ai/goose-skills

Extract competitor and customer intelligence from any company's landing page HTML. Discovers tech stack, analytics tools, ad pixels, customer logos, SEO metadata, CTAs, hidden elements, and more. No API keys required.

gooseworks-ai/goose-skills

Find speakers, hosts, and guest profiles at conferences and events on Luma. Two modes - free direct scrape for hosts, or Apify-powered search for full guest profiles with LinkedIn/Twitter/bio.

gooseworks-ai/goose-skills

Find Twitter/X influencers to promote a product or brand. Use when asked to find influencers, discover Twitter accounts for partnerships, identify creators in a niche, or build an influencer outreach list.

Skills relacionados