Communitygithub.com

adobe/skills

Redimensiona fotos y vídeos a dimensiones exactas en píxeles o relaciones de aspecto usando herramientas de Adobe.

¿Qué es skills?

Esta habilidad permite a un agente de IA redimensionar imágenes y vídeos a dimensiones específicas (píxeles, relación de aspecto o tamaño predefinido) utilizando la API de Adobe. Está diseñada para plataformas como Claude Code, Cursor o Codex, e integra herramientas como `image_crop_and_resize` para fotos y `video_resize` para vídeos. La habilidad maneja desde solicitudes simples como 'redimensionar a 1920x1080' hasta flujos complejos con múltiples imágenes, modo de ajuste (recortar, rellenar o extraer), enfoque inteligente (sujeto, rostro, etc.) y subida opcional a Creative Cloud con creación de tablero Firefly. El flujo de trabajo incluye pasos de inicialización obligatoria, verificación de permisos, recolección de parámetros mediante preguntas al usuario, procesamiento por lotes y previsualización final de todos los resultados.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adobe/skills/tree/HEAD/plugins/creative-cloud/adobe-for-creativity/skills/adobe-resize-photos-and-videos

Preguntar en tu IA favorita

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

Documentación

Adobe Redimensionar Fotos y Vídeos

Redimensiona imágenes o vídeos a dimensiones especificadas por el usuario, relación de aspecto o tamaño predefinido. Para conjuntos de plataformas sociales (Instagram, TikTok, etc.) → usa la habilidad adobe-create-social-variations en su lugar.


Referencia de Herramientas

PasoHerramientaNotas
Abrir selector de archivosasset_add_fileDevuelve presignedAssetUrl, assetId y mediaType
Buscar activo en CCasset_searchRe-escalona el resultado mediante asset_add_file para imagen; usa id directamente para vídeo
Renderizar PSD/AIdocument_render_vectorConvierte a JPEG antes de redimensionar
Redimensionar imagenimage_crop_and_resizeUna llamada por dimensión; reframe por defecto
Previsualizar salidasasset_preview_fileTodas las salidas en una sola llamada
Subir a CC (inicio)asset_initialize_file_uploadPrimera llamada en la canalización de subida por bloques
Subir a CC (fin)asset_finalize_file_uploadSegunda llamada; devuelve URL presigned de CC para el tablero
Crear tablero Fireflycreate_firefly_boardPasa import_adobe_storage con la URL finalizada
Redimensionar vídeovideo_resizeDevuelve statusId para sondeo
Sondeo de redimensionamiento de vídeoresizeVideoPollHerramienta diferida: cárgala antes de usarla

Flujo de trabajo

Paso 0 — Inicializar herramientas de Adobe

Llama primero a adobe_mandatory_init. Esto devuelve reglas de manejo de archivos y guía de enrutamiento de herramientas necesarias para el resto del flujo.

{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }

Paso 1 — Verificación de permisos

Ahora que adobe_mandatory_init confirmó que el conector "Adobe for creativity" está activo, verifica qué herramientas están disponibles a través del conector "Adobe for creativity" cotejando con la tabla de Referencia de Herramientas anterior.


ACCIÓN INMEDIATA REQUERIDA

Paso 1: Si faltan parámetros o son ambiguos → ejecuta la toma de requisitos de varios pasos (Paso 2 a continuación). Paso 2: Si no se ha subido ningún archivo, ejecuta el Paso 3 (asset_add_file({})). Paso 3: Detecta si es imagen o vídeo y enruta al flujo correcto (Paso 5 Imagen/Vídeo).


Paso 2 — Toma de requisitos de varios pasos

Ejecuta esto cuando el usuario no haya proporcionado parámetros completos (tipo + dimensiones + modo de ajuste). Omítelo por completo si el mensaje del usuario ya contiene los tres.

Usa AskUserQuestion para recopilar los parámetros paso a paso.

Paso 2a — Tipo

AskUserQuestion([{
  question: "¿Foto o vídeo?",
  type: "single_select",
  options: ["Foto", "Vídeo"]
}])

Paso 2b — Dimensiones

Si es Foto (multi_select — el usuario puede elegir una o más):

AskUserQuestion([{
  question: "Dimensiones — selecciona todas las que necesites",
  type: "multi_select",
  options: [
    "1080 × 1080 — Cuadrado de Instagram",
    "1080 × 1350 — Retrato de Instagram",
    "1080 × 1920 — Historias / Reels",
    "1920 × 1080 — YouTube / horizontal",
    "1280 × 720 — Miniatura de YouTube",
    "1200 × 675 — Publicación en X / Twitter",
    "1200 × 630 — Facebook / imagen OG",
    "1080 × 566 — Publicación en LinkedIn",
    "2560 × 1440 — Banner de YouTube",
    "3840 × 2160 — 4K / UHD",
    "400 × 400 — Perfil / avatar",
    "2480 × 3508 — Impresión A4 (300 ppp)",
    "Personalizado — lo escribiré"
  ]
}])

Si el usuario incluye "Personalizado" → pregunta: "Introduce tus dimensiones personalizadas (ej. 1500×800):"

Si el usuario selecciona varios preajustes → ejecuta image_crop_and_resize una vez por cada dimensión, usando la misma URI de origen y parámetros cada vez. Previsualiza todas las salidas juntas al final.

Si es Vídeo (multi_select — el usuario puede elegir una o más):

AskUserQuestion([{
  question: "Dimensiones — selecciona todas las que necesites",
  type: "multi_select",
  options: [
    "1080 × 1920 — Reels / TikTok / Historias",
    "1920 × 1080 — YouTube / horizontal",
    "1080 × 1080 — Publicación cuadrada",
    "1280 × 720 — YouTube 720p",
    "3840 × 2160 — 4K / UHD",
    "854 × 480 — SD / 480p",
    "Personalizado — lo escribiré"
  ]
}])

Si el usuario selecciona varios preajustes de vídeo → envía un trabajo video_resize separado por cada dimensión, sondea cada uno hasta completarlos, previsualiza todas las salidas juntas.

Paso 2c — Modo de ajuste

Si es Foto (single_select):

AskUserQuestion([{
  question: "Modo de ajuste",
  type: "single_select",
  options: [
    "Reencuadrar — recortar para llenar",
    "Rellenar — bandas negras, sin recorte",
    "Extraer — aislar sujeto"
  ]
}])

Si es Vídeo (single_select):

AskUserQuestion([{
  question: "Modo de ajuste",
  type: "single_select",
  options: [
    "Letterbox — preservar proporción",
    "Recortar — llenar, sin barras",
    "Estirar — forzar exacto (distorsionar)"
  ]
}])

Paso 2d — Enfoque inteligente (solo Foto)

AskUserQuestion([{
  question: "Enfoque inteligente — ¿dónde debe centrarse el recorte?",
  type: "single_select",
  options: [
    "Sujeto",
    "Rostro / retrato",
    "Parte superior del cuerpo",
    "Centro (geométrico)",
    "Objeto nombrado — lo describiré"
  ]
}])

Si el usuario selecciona "Objeto nombrado" → pregunta: "Describe el objeto (ej. 'el coche rojo', 'el logo'):"

Paso 2e — Opciones (solo Foto)

AskUserQuestion([{
  question: "¿Alguna opción adicional?",
  type: "multi_select",
  options: [
    "Lote — múltiples imágenes",
    "Salida: JPEG",
    "Salida: PNG"
  ]
}])

Paso 2f — Origen (solo Vídeo)

AskUserQuestion([{
  question: "¿Dónde está el vídeo?",
  type: "single_select",
  options: [
    "Subir desde el dispositivo",
    "Desde Creative Cloud"
  ]
}])

Paso 3 — Obtener el archivo de origen

Importante — las rutas /mnt/user-data/uploads/ NO son URLs utilizables. Incluso cuando el usuario ha adjuntado un archivo y aparece en el contexto en una ruta /mnt/user-data/uploads/, no puedes pasar esta ruta a ninguna herramienta de Adobe. Llama a asset_add_file() para preparar el archivo — las rutas /mnt/user-data/uploads/ no son recuperables por las herramientas de Adobe.

INCORRECTO  ❌  imageURI: "/mnt/user-data/uploads/photo.jpg"
INCORRECTO  ❌  imageURI: "file:///mnt/user-data/uploads/photo.jpg"
CORRECTO    ✅  llama a asset_add_file() → usa presignedAssetUrl del contexto del selector

Aún no hay archivo → abre el selector inmediatamente:

asset_add_file()

Detecta el tipo a partir del mediaType devuelto:

  • image/* → FLUJO DE IMAGEN
  • video/* → FLUJO DE VÍDEO

Paso 4 — Resolver dimensiones objetivo

El usuario diceResolver a
1920×1080, 1920x1080ancho: 1920, alto: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
Impresión A42480 × 3508 (300 DPI vertical)
Impresión Carta2550 × 3300 (300 DPI vertical)
16:9, 1:1, 4:5, 9:16cadena de proporción → pasar como output: "16:9"
cuadradooutput: "1:1"
Solo ancho (800px de ancho)ancho: 800, usa cadena de proporción para mantener relación de aspecto

Si no se especificó ningún objetivo en el formulario Y ninguno en el mensaje del usuario → pregunta:

"¿Qué dimensiones necesitas? (ej. 1920×1080, A4, 16:9)"


FLUJO DE IMAGEN

Paso 5 (Imagen) — Fuentes URI válidas

Solo estas funcionan como imageURI:

  • presignedAssetUrl de asset_add_file() ✅
  • outputUrl de una llamada de herramienta anterior ✅
  • URL HTTPS pública proporcionada por el usuario ✅

No usable como imageURI:

  • Rutas /mnt/user-data/uploads/ ❌
  • renditionURL de asset_search directamente ❌
  • URIs file:// ❌
OrigenResolución
Archivo subidoasset_add_file() → presignedAssetUrl
Activo en almacén CCasset_search → re-escalonar mediante asset_add_file() → presignedAssetUrl
Salida de herramienta anteriorUsa outputUrl directamente
Archivo PSD / AIdocument_render_vector (JPEG, 300 DPI) → outputPresignedUrl

Paso 6 (Imagen) — Modo de ajuste

IntenciónModoNotas
"redimensionar a WxH" / por defectoreframeRecorte más grande en la proporción objetivo, centrado — sin distorsión
"sin recortar", "letterbox", "ajustar dentro"padRellena el espacio vacío con blanco
"aislar sujeto", "recorte ajustado"extractRecorte ajustado alrededor de la región detectada

Por defecto: reframe. Cámbialo solo cuando el usuario sea explícito.

⛔ fit: "extract" es incompatible con un { width, height } explícito — estira la imagen. Usa una cadena de proporción u omite output.


Paso 7 (Imagen) — Llamar a image_crop_and_resize

image_crop_and_resize({
  imageURI: presignedAssetUrl,
  options: {
    output: { width: 1920, height: 1080 },  // o "16:9"
    fit: "reframe",
    focus: "subject",  // o "face", "upper_body", { prompt: "the car" }, { x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // o "png" si se necesita transparencia
})
// result.outputUrl → usar para previsualización o encadenamiento

Guía de enfoque:

  • "subject" — por defecto; detección de cuerpo completo, paisajes, objetos
  • "face" — retratos, primeros planos
  • "upper_body" — recortes de pecho hacia arriba
  • { prompt: "the logo" } — objeto nombrado de la entrada del formulario del usuario
  • { x: 0.5, y: 0.5 } — centro geométrico (sin sujeto claro)

Paso 8 (Imagen) — Lote

Si se seleccionó lote en el formulario O el usuario proporcionó varios archivos:

  1. Llama a asset_add_file() por cada archivo para obtener URLs presigned individuales
  2. Llama a image_crop_and_resize por cada uno con los mismos parámetros
  3. Recoge todos los valores outputUrl
  4. Llama a asset_preview_file con todas las salidas en una sola llamada

Las llamadas se ejecutan secuencialmente en este entorno. Para más de 10 imágenes, confirma con el usuario antes de comenzar.

Paginación entre turnos (lotes >20): Para lotes grandes, el contexto de la conversación puede llenarse antes de que se procesen todas las imágenes, lo que hace que Claude se detenga a mitad del lote. Esto es esperado — no es un error. Cuando ocurra:

  • Indica cuántas se han completado y cuántas quedan (ej. "20 / 24 hechas — di 'continuar' para el resto")
  • Espera a que el usuario confirme antes de reanudar
  • Al reanudar, continúa desde la siguiente imagen no procesada y sigue hasta el final
  • Previsualiza todas las salidas juntas solo después de que se complete la imagen final

Paso 9 (Imagen) — Previsualizar + Entregar + Tablero Firefly

asset_preview_file({
  assets: [
    { name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
    // todas las salidas exitosas
  ]
})

Guardar en CC + Crear tablero Firefly

Después de la previsualización, sube cada salida al almacenamiento CC usando la canalización de subida por bloques (asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).

Luego llama a la herramienta de tablero Firefly con las URLs de salida finales:

create_firefly_board({
  import_adobe_storage: [
    final_output_url_1,
    final_output_url_2,
    // ...
  ]
})

✅ Confirmado que funciona (Stage): import_adobe_storage con URLs presigned de asset_finalize_file_upload llena tableros con éxito.

❌ No funciona: import_generic_assets con IDs de activos CC (urn:aaid:sc:US:...) — el retraso de indexación USS causa tableros en blanco.

Si la creación del tablero falla o la URL está mal formada, omite el enlace del tablero (reintentar no ayuda).

Publica el resumen de finalización después del paso del tablero:

✅ ¡Hecho! [N] imagen(es) redimensionada(s) y lista(s).

📥 Descargar:
• resized_1920x1080.jpg → <cc_storage_url>
[lista individualmente si N ≤ 3, o enlace de carpeta única si N > 3]

🎨 Ver en tablero Firefly → <board_url>   ← omitir si la creación del tablero falló

FLUJO DE VÍDEO

Paso 5 (Vídeo) — Obtener ID del activo

Las herramientas de vídeo requieren assetId, no una URL.

OrigenCómo
Subir mediante asset_add_fileUsa el assetId devuelto
Almacenamiento CCasset_search con filters.mediaType: "video/mp4" → usa el id del activo

Paso 6 (Vídeo) — Objetivos comunes

NombreDimensiones
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
Vertical 9:161080 × 1920
Cuadrado 1:11080 × 1080

Paso 7 (Vídeo) — Llamar a video_resize

⚠️ resizeVideoPoll es una herramienta diferida — cárgala primero antes de intentar sondear. Las llamadas directas sin cargarla fallarán con error "no cargada".

video_resize({
  assetId: videoAssetId,
  width: targetW,
  height: targetH,
  mode: "letterbox"  // por defecto; ver tabla de modos a continuación
})
// Devuelve { jobStatus: "pending", statusId }

Modo — usa valores exactos de la API (no etiquetas para el usuario):

El usuario diceValor APIComportamiento
"ajustar", "preservar proporción", "letterbox""letterbox"Preserva la proporción, añade barras negras (por defecto)
"llenar", "recortar para llenar", "sin barras""crop"Recorta los bordes para llenar exactamente el objetivo
"estirar", "forzar exacto""stretch"Distorsiona para ajustarse exactamente al objetivo

ℹ️ El reencuadre automático para vídeo no está disponible en Claude aún, pero se están añadiendo nuevas herramientas constantemente. Si necesitas más control, prueba con Adobe Premiere.

Sondeo: carga la herramienta diferida resizeVideoPoll antes de llamarla — las llamadas directas fallan con "no cargada".

// Paso 1: cargar la herramienta diferida
const resizeVideoPoll = await loadTool("resizeVideoPoll");

// Paso 2: sondear el estado
const pollResult = await resizeVideoPoll({ statusId: recibidoStatusId });

Paso 8 (Vídeo) — Previsualizar + Entregar

Una vez que el sondeo devuelva jobStatus: "completed", la salida está lista en el almacenamiento CC.

// Obtener el activo de salida mediante su ID
const updatedAsset = await asset_search({ filters: { id: assetId } });

// Previsualizar el vídeo redimensionado
asset_preview_file({
  assets: [
    { name: "video_1920x1080.mp4", assetId: updatedAsset.id }
  ]
})
// Si asset_preview_file no acepta assetId, obtén una URL presigned mediante asset_add_file({ assetId })

Guardar en CC + Crear tablero Firefly

await initializeFileUpload(...);
await finalizeFileUpload(...);

create_firefly_board({
  import_adobe_storage: [final_adobe_storage_url]
})

Publica un mensaje de finalización:

✅ Vídeo redimensionado y listo.

📥 Descargar: · video_1920x1080.mp4 → <enlace_cc>
🎨 Ver en tablero Firefly → <enlace_tablero>

Consejos de calidad

Imágenes

  • Calidad (quality): Rango 0–10; 7 es un buen equilibrio entre calidad y tamaño de archivo. Usa 10 para salida final, 5 para borradores rápidos.
  • Tipo de archivo de salida: "jpeg" para fotos, "png" para gráficos con transparencia.

Vídeos

  • Elevación: El flujo de trabajo de vídeo no puede elevar la resolución — si la fuente tiene menos píxeles que el objetivo, el vídeo se verá borroso.
  • Múltiples salidas: Múltiples dimensiones significan múltiples trabajos, cada uno con su propio ID de sondeo. Gestiona cada uno de forma independiente.

Manejo de errores

ErrorCausaSolución
"not loaded" en resizeVideoPollNo se cargó la herramienta diferidaUsa loadTool("resizeVideoPoll") primero, no la llames directamente
"Asset not found"AssetId incorrecto o vencidoVuelve a obtener el activo mediante asset_search o asset_add_file
Tablero Firefly en blancoImportación con IDs de activos CCUsa import_adobe_storage con URLs presigned en su lugar
"Invalid imageURI"Se pasó una ruta /mnt/user-data/uploads/Siempre usa asset_add_file() para obtener una URL presigned

Ejemplo de sesión

Usuario: "Redimensiona esta foto a 1920x1080"

Agente: "Claro. Voy a redimensionar esta foto a 1920×1080 con recorte centrado."

  1. Llama a asset_add_file() → obtiene URL presigned
  2. Detecta mediaType: "image/jpeg" → usa flujo de imagen
  3. Llama a image_crop_and_resize({ imageURI, options: { output: { width: 1920, height: 1080 }, fit: "reframe", focus: "subject" }, outputFileType: "jpeg" })
  4. Llama a asset_preview_file({ assets: [{ name: "photo_1920x1080.jpg", presignedAssetUrl: resultado.outputUrl }] })
  5. Sube a CC y crea tablero Firefly
  6. Publica resumen de finalización con enlaces de descarga y tablero

Skills relacionados