← All playbooks · Raw API

task-news-images

# Capability: News article images (composite)

## Intent phrases

- create news article images
- branded news card image
- OG image for press release
- news composite image

## Requires capabilities

`articles`

## Prerequisites

- Read `cms-edit://customer/news-images`
- Read `cms-edit://customer/news-pages`
- `cms_edit ["index", "sync"]`

## Steps

### When user supplies composite image files (hosted MCP)

1. `cms_edit ["index", "sync"]`
2. Search for existing `News composite —` assets and shared Media entry — see `news-images` **Hosted MCP workflow**
3. Link **same** `visuals[0]` media entry ID + `featuredImage` asset ID to each article; upload + `create media` only once per composite
4. `preview urls` → `diff` → `save` → `task-publish-handoff`

**Do not** use `asset upload --with-media` or `create media` per article for shared composites.

### When studio is available (dev/preview)

1. Open `/cms/news-images?slug={slug}` on preview
2. Preview portrait + landscape; apply or reuse composite
3. `preview urls` → `diff` → `save` → `task-publish-handoff`

## Confirmation gates

1. Before upload, report search results; copy IDs from a sibling article when the composite already exists
2. After a batch, confirm all articles share the **same** media entry ID for `visuals[0]`