Communitygithub.com

adobe/skills

Ändert die Größe von Fotos und Videos auf exakte Pixelmaße oder Seitenverhältnisse mit Adobe-Werkzeugen.

Was ist skills?

Dieses Skill ermöglicht es KI-Agenten, Bilder und Videos mithilfe von Adobe-Tools auf benutzerdefinierte Abmessungen, Seitenverhältnisse oder benannte Größen zu skalieren. Es eignet sich für Aufgaben wie das Anpassen der Bildgröße auf 1920x1080, die Konvertierung in 4K, die Anpassung des Seitenverhältnisses auf 16:9 oder die Batch-Verarbeitung mehrerer Dateien. Das Skill unterstützt sowohl Foto- als auch Video-Workflows: Für Bilder werden `image_crop_and_resize` mit verschiedenen Anpassungsmodi (Reframe, Pad, Extract) und intelligenten Fokusoptionen verwendet, während für Videos `video_resize` mit Modi wie Letterbox, Crop und Stretch zum Einsatz kommt. Es integriert sich nahtlos in die Adobe Creative Cloud, ermöglicht die Dateiauswahl über `asset_add_file`, das Rendern von PSD/AI-Dateien über `document_render_vector` und die Erstellung von Firefly-Boards zur visuellen Organisation. Das Skill ist für den Einsatz in Claude Code, Cursor und Codex konzipiert und bietet eine strukturierte Mehrschritt-Eingabe, um Benutzer durch die Parameter zu führen, wenn Angaben unvollständig sind.

Funktioniert mit✓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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Adobe Fotos und Videos in der Größe ändern

Ändert die Größe von Bildern oder Videos auf benutzerdefinierte Abmessungen, Seitenverhältnisse oder benannte Größen. Für Social-Media-Plattform-Sets (Instagram, TikTok usw.) → stattdessen das adobe-create-social-variations-Skill verwenden.


Werkzeugreferenz

SchrittWerkzeugNotizen
Dateiauswahl öffnenasset_add_fileGibt presignedAssetUrl, assetId und mediaType zurück
Asset in CC suchenasset_searchErgebnis für Bilder über asset_add_file neu bereitstellen; id direkt für Videos verwenden
PSD/AI renderndocument_render_vectorKonvertiert vor der Größenänderung in JPEG
Bildgröße ändernimage_crop_and_resizeEin Aufruf pro Dimension; reframe standardmäßig
Vorschau der Ausgabenasset_preview_fileAlle Ausgaben in einem einzigen Aufruf
In CC hochladen (Start)asset_initialize_file_uploadErster Aufruf im Block-Upload-Pipeline
In CC hochladen (Ende)asset_finalize_file_uploadZweiter Aufruf; gibt signierte CC-URL für das Board zurück
Firefly-Board erstellencreate_firefly_boardimport_adobe_storage mit der Finalize-URL übergeben
Videogröße ändernvideo_resizeGibt statusId für Polling zurück
Polling der VideogrößenänderungresizeVideoPollDeferred-Tool – vor dem Aufruf laden

Arbeitsablauf

Schritt 0 – Adobe-Tools initialisieren

Zuerst adobe_mandatory_init aufrufen. Dies gibt Dateiverarbeitungsregeln und Tool-Routing-Anleitungen zurück, die für den Rest des Arbeitsablaufs erforderlich sind.

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

Schritt 1 – Berechtigungsprüfung

Nachdem adobe_mandatory_init bestätigt hat, dass der Connector „Adobe for creativity“ aktiv ist, prüfen, welche Tools über diesen Connector verfügbar sind, indem die obige Werkzeugreferenz-Tabelle abgeglichen wird.


SOFORTIGE MASSNAHME ERFORDERLICH

Schritt 1: Wenn Parameter fehlen oder mehrdeutig sind → die mehrstufige Eingabe (Schritt 2 unten) ausführen. Schritt 2: Wenn keine Datei hochgeladen wurde, Schritt 3 (asset_add_file({})) ausführen. Schritt 3: Bild vs. Video erkennen und zum richtigen Arbeitsablauf leiten (Schritt 5 Bild/Video).


Schritt 2 – Mehrstufige Eingabe

Ausführen, wenn der Benutzer keine vollständigen Parameter (Typ + Abmessungen + Anpassungsmodus) angegeben hat. Vollständig überspringen, wenn die Nachricht des Benutzers bereits alle drei enthält.

AskUserQuestion verwenden, um Parameter Schritt für Schritt zu sammeln.

Schritt 2a – Typ

AskUserQuestion([{
  question: "Foto oder Video?",
  type: "single_select",
  options: ["Foto", "Video"]
}])

Schritt 2b – Abmessungen

Wenn Foto (multi_select – Benutzer kann eine oder mehrere auswählen):

AskUserQuestion([{
  question: "Abmessungen – wählen Sie alle, die Sie benötigen",
  type: "multi_select",
  options: [
    "1080 × 1080 – Instagram Quadrat",
    "1080 × 1350 – Instagram Hochformat",
    "1080 × 1920 – Stories / Reels",
    "1920 × 1080 – YouTube / Querformat",
    "1280 × 720 – YouTube Thumbnail",
    "1200 × 675 – X / Twitter Post",
    "1200 × 630 – Facebook / OG Image",
    "1080 × 566 – LinkedIn Post",
    "2560 × 1440 – YouTube Banner",
    "3840 × 2160 – 4K / UHD",
    "400 × 400 – Profil / Avatar",
    "2480 × 3508 – A4 Druck (300 dpi)",
    „Benutzerdefiniert – Ich gebe es ein“
  ]
}])

Wenn der Benutzer „Benutzerdefiniert“ auswählt → nachfragen: „Geben Sie Ihre benutzerdefinierten Abmessungen ein (z.B. 1500×800):“

Wenn der Benutzer mehrere Voreinstellungen auswählt → image_crop_and_resize einmal pro Dimension ausführen, wobei jedes Mal dieselbe Quell-URI und dieselben Parameter verwendet werden. Alle Ausgaben am Ende gemeinsam als Vorschau anzeigen.

Wenn Video (multi_select – Benutzer kann eine oder mehrere auswählen):

AskUserQuestion([{
  question: "Abmessungen – wählen Sie alle, die Sie benötigen",
  type: "multi_select",
  options: [
    "1080 × 1920 – Reels / TikTok / Stories",
    "1920 × 1080 – YouTube / Querformat",
    "1080 × 1080 – Quadratischer Post",
    "1280 × 720 – YouTube 720p",
    "3840 × 2160 – 4K / UHD",
    „854 × 480 – SD / 480p",
    „Benutzerdefiniert – Ich gebe es ein“
  ]
}])

Wenn der Benutzer mehrere Video-Voreinstellungen auswählt → einen separaten video_resize-Job pro Dimension einreichen, jeden bis zum Abschluss abfragen, alle Ausgaben gemeinsam als Vorschau anzeigen.

Schritt 2c – Anpassungsmodus

Wenn Foto (single_select):

AskUserQuestion([{
  question: "Anpassungsmodus",
  type: "single_select",
  options: [
    „Reframe – zuschneiden, um auszufüllen"
    „Pad – Letterbox, kein Zuschnitt“
    „Extract – Motiv isolieren“
  ]
}])

Wenn Video (single_select):

AskUserQuestion([{
  question: "Anpassungsmodus",
  type: "single_select",
  options: [
    "Letterbox – Verhältnis beibehalten",
    „Zuschneiden – ausfüllen, keine Balken“
    „Strecken – exakt erzwingen (verzerren)“
  ]
}])

Schritt 2d – Intelligenter Fokus (nur Foto)

AskUserQuestion([{
  question: "Intelligenter Fokus – wo soll der Zuschnitt zentriert werden?",
  type: "single_select",
  options: [
    "Motiv",
    "Gesicht/Portrait",
    „Oberkörper“,
    
    "Mitte (geometrisch)",
    „Benanntes Objekt – Ich beschreibe es“
  ]
}])

Wenn der Benutzer „Benanntes Objekt“ auswählt → nachfragen: „Beschreiben Sie das Objekt (z.B. ‚das rote Auto‘, ‚das Logo‘):“

Schritt 2e – Optionen (nur Foto)

AskUserQuestion([{
  question: "Zusätzliche Optionen?",
  type: "multi_select",
  options: [
    "Stapel – mehrere Bilder",
    "Ausgabe: JPEG",
    "Ausgabe: PNG"
  ]
}])

Schritt 2f – Quelle (nur Video)

AskUserQuestion([{
  question: "Wo befindet sich das Video?",
  type: "single_select",
  options: [
    "Vom Gerät hochladen",
    "Aus Creative Cloud"
  ]
}])

Schritt 3 – Quelldatei abrufen

Wichtig – /mnt/user-data/uploads/-Pfade sind KEINE verwendbaren URLs. Selbst wenn der Benutzer eine Datei angehängt hat und sie im Kontext unter einem /mnt/user-data/uploads/-Pfad erscheint, können Sie diesen Pfad nicht an ein Adobe-Tool übergeben. Rufen Sie asset_add_file() auf, um die Datei bereitzustellen – /mnt/user-data/uploads/-Pfade können von Adobe-Tools nicht abgerufen werden.

FALSCH  ❌  imageURI: "/mnt/user-data/uploads/photo.jpg"
FALSCH  ❌  imageURI: "file:///mnt/user-data/uploads/photo.jpg"
RICHTIG ✅  asset_add_file() aufrufen → presignedAssetUrl aus dem Auswahlkontext verwenden

Noch keine Datei → sofort die Auswahl öffnen:

asset_add_file()

Typ aus dem zurückgegebenen mediaType erkennen:

  • image/* → BILD-WORKFLOW
  • video/* → VIDEO-WORKFLOW

Schritt 4 – Zielabmessungen auflösen

Benutzer sagtAuflösen zu
1920×1080, 1920x1080width: 1920, height: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
A4 Druck2480 × 3508 (300 DPI Hochformat)
Letter Druck2550 × 3300 (300 DPI Hochformat)
16:9, 1:1, 4:5, 9:16Verhältniszeichenfolge → als output: "16:9" übergeben
squareoutput: "1:1"
Nur Breite (800px breit)width: 800, Verhältniszeichenfolge verwenden, um Seitenverhältnis beizubehalten

Wenn kein Ziel im Formular UND in der Benutzernachricht angegeben wurde → fragen:

„Welche Abmessungen benötigen Sie? (z.B. 1920×1080, A4, 16:9)"


BILD-WORKFLOW

Schritt 5 (Bild) – Gültige URI-Quellen

Nur diese funktionieren als imageURI:

  • presignedAssetUrl von asset_add_file() ✅
  • outputUrl von einem vorherigen Tool-Aufruf ✅
  • Öffentliche HTTPS-URL vom Benutzer ✅

Nicht verwendbar als imageURI:

  • /mnt/user-data/uploads/-Pfade ❌
  • renditionURL von asset_search direkt ❌
  • file://-URIs ❌
QuelleAuflösung
Hochgeladene Dateiasset_add_file() → presignedAssetUrl
CC-Speicher-Assetasset_search → über asset_add_file() neu bereitstellen → presignedAssetUrl
Vorherige Tool-AusgabeoutputUrl direkt verwenden
PSD / AI-Dateidocument_render_vector (JPEG, 300 DPI) → outputPresignedUrl

Schritt 6 (Bild) – Anpassungsmodus

AbsichtModusNotizen
„Größe auf WxH ändern“ / StandardreframeGrößter Zuschnitt im Zielverhältnis, zentriert – keine Verzerrung
„Kein Zuschnitt“, „Letterbox“, „hineinpassen“padFüllt leeren Raum mit Weiß
„Motiv isolieren“, „enger Zuschnitt“extractEnger Zuschnitt um erkannten Bereich

Standard: reframe. Nur ändern, wenn der Benutzer explizit ist.

⛔ fit: "extract" ist inkompatibel mit explizitem { width, height } – es streckt das Bild. Eine Verhältniszeichenfolge verwenden oder output weglassen.


Schritt 7 (Bild) – image_crop_and_resize aufrufen

image_crop_and_resize({
  imageURI: presignedAssetUrl,
  options: {
    output: { width: 1920, height: 1080 },  // oder "16:9"
    fit: "reframe",
    focus: "subject",  // oder "face", "upper_body", { prompt: "the car" }, { x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // oder "png" bei Transparenzbedarf
})
// result.outputUrl → für Vorschau oder Verkettung verwenden

Fokus-Referenz:

  • "subject" – Standard; Ganzkörpererkennung, Landschaften, Objekte
  • "face" – Porträts, Kopfaufnahmen
  • "upper_body" – Zuschnitte ab Brusthöhe
  • { prompt: "the logo" } – benanntes Objekt aus dem Formular des Benutzers
  • { x: 0.5, y: 0.5 } – geometrischer Mittelpunkt (kein klares Motiv)

Schritt 8 (Bild) – Stapel

Wenn Stapel im Formular ausgewählt wurde ODER der Benutzer mehrere Dateien bereitgestellt hat:

  1. asset_add_file() für jede Datei aufrufen, um individuelle signierte URLs zu erhalten
  2. image_crop_and_resize für jede mit denselben Parametern aufrufen
  3. Alle outputUrl-Werte sammeln
  4. asset_preview_file mit allen Ausgaben in einem einzigen Aufruf aufrufen

Aufrufe erfolgen in dieser Umgebung sequenziell. Bei >10 Bildern vor dem Start mit dem Benutzer bestätigen.

Seitenweise Aufteilung über Gesprächsrunden (Stapel >20): Bei großen Stapeln kann der Gesprächskontext gefüllt sein, bevor alle Bilder verarbeitet sind, wodurch Claude mitten im Stapel pausiert. Dies ist erwartet – kein Fehler. Wenn es passiert:

  • Angeben, wie viele abgeschlossen und wie viele übrig sind (z.B. „20 / 24 erledigt – sagen Sie ‚weiter‘ für den Rest“)
  • Auf Bestätigung des Benutzers warten, bevor fortgefahren wird
  • Beim Fortsetzen mit dem nächsten unverarbeiteten Bild weitermachen und bis zum Ende fortfahren
  • Alle Ausgaben erst nach Abschluss des letzten Bildes gemeinsam als Vorschau anzeigen

Schritt 9 (Bild) – Vorschau + Bereitstellen + Firefly-Board

asset_preview_file({
  assets: [
    { name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
    // alle erfolgreichen Ausgaben
  ]
})

In CC speichern + Firefly-Board erstellen

Nach der Vorschau jede Ausgabe mit der Block-Upload-Pipeline in den CC-Speicher hochladen (asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).

Dann das Firefly-Board-Tool mit den endgültigen Ausgabe-URLs aufrufen:

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

✅ Bestätigt funktionierend (Stage): import_adobe_storage mit signierten URLs von asset_finalize_file_upload füllt Boards erfolgreich.

❌ Funktioniert nicht: import_generic_assets mit CC-Asset-IDs (urn:aaid:sc:US:...) – USS-Indexierungsverzögerung verursacht leere Boards.

Wenn die Board-Erstellung fehlschlägt oder die URL fehlerhaft ist, den Board-Link weglassen (Wiederholen hilft nicht).

Die Zusammenfassung nach dem Board-Schritt posten:

✅ Fertig! [N] Bild(er) wurden in der Größe geändert und sind bereit.

📥 Herunterladen:
• resized_1920x1080.jpg → <cc_storage_url>
[Einzeln auflisten, wenn N ≤ 3, oder einzelner Ordner-Link, wenn N > 3]

🎨 Im Firefly-Board anzeigen → <board_url>   ← weglassen, wenn Board-Erstellung fehlgeschlagen ist

VIDEO-WORKFLOW

Schritt 5 (Video) – Asset-ID abrufen

Video-Tools benötigen assetId, keine URL.

QuelleVorgehen
Hochladen über asset_add_fileZurückgegebene assetId verwenden
CC-Speicherasset_search mit filters.mediaType: "video/mp4" → Asset-id verwenden

Schritt 6 (Video) – Gängige Ziele

NameAbmessungen
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
Vertikal 9:161080 × 1920
Quadrat 1:11080 × 1080

Schritt 7 (Video) – video_resize aufrufen

⚠️ resizeVideoPoll ist ein deferred-Tool – zuerst laden, bevor ein Polling versucht wird. Direkte Aufrufe ohne Laden schlagen mit einem „not loaded“-Fehler fehl.

video_resize({
  assetId: videoAssetId,
  width: targetW,
  height: targetH,
  mode: "letterbox"  // Standard; siehe Modustabelle unten
})
// Gibt { jobStatus: "pending", statusId } zurück

Modus – exakte API-Werte verwenden (nicht benutzerorientierte Bezeichnungen):

Benutzer sagtAPI-WertVerhalten
„anpassen

Verwandte Skills