Add Save Set To Content action and update README with usage details

Author: suedeapple

.github/README.md

@@ -127,6 +127,64 @@ The action outputs the following, which can be referenced via bindings in later
 | Sets | The page of matching sets returned, summarised (SetNumber, Name, Year, Theme, Subtheme, Pieces, Minifigs, ThumbnailUrl, BricksetUrl, Rating, RetailPriceUs, RetailPriceUk, RetailPriceCa, RetailPriceDe). |
 | RawResponse | The full, unprocessed JSON response returned by the Brickset API. |
 
+### Save Set To Content
+
+Add the **Save Set To Content** action to any automation. Writes fields from a Brickset set lookup onto a content item's properties (a draft save) — combine with a **Publish Content** step in a subsequent step to publish the result. Requires the `Umb.Document.Update` permission and the `content` section.
+
+Each field below is optional (other than **Content Key**) and writes to a hardcoded property alias on the target content item — a field with a supplied value is silently skipped if the content type doesn't have the matching property, so you only need to add the properties for the fields you actually use.
+
+| Field | Writes to property alias | Description |
+|---|---|---|
+| Content Key | — | Required. The key (GUID) of the content item to update. Supports `${ binding }` expressions. |
+| Node Name | — | Optional. When supplied, renames the content item itself (its node name), independent of the Name field below. Supports `${ binding }` expressions. |
+| Set Id | `bricksetSetId` | Brickset's internal numeric ID for the set. |
+| Name | `bricksetName` | The set's name, e.g. "Millennium Falcon". |
+| Set Number | `bricksetSetNumber` | The resolved set number including variant suffix, e.g. "71043-1". |
+| Year | `bricksetYear` | The year the set was released. |
+| Theme | `bricksetTheme` | The theme, e.g. "Star Wars". |
+| Subtheme | `bricksetSubtheme` | The subtheme, e.g. "Ultimate Collector Series". |
+| Pieces | `bricksetPieces` | The number of pieces in the set. |
+| Minifigs | `bricksetMinifigs` | The number of minifigs included in the set. |
+| Image Url | `bricksetImageUrl` | The URL of the full-size set image. |
+| Thumbnail Url | `bricksetThumbnailUrl` | The URL of the thumbnail set image. |
+| Brickset Url | `bricksetUrl` | The URL of the set's page on Brickset. |
+| Rating | `bricksetRating` | The average user rating for the set. |
+| Review Count | `bricksetReviewCount` | The number of user reviews for the set. |
+| Packaging Type | `bricksetPackagingType` | The packaging type, e.g. "Box". |
+| Availability | `bricksetAvailability` | The set's availability, e.g. "Retail". |
+| Instructions Count | `bricksetInstructionsCount` | The number of instructions available for the set. |
+| Age Min | `bricksetAgeMin` | The minimum recommended age for the set. |
+| Age Max | `bricksetAgeMax` | The maximum recommended age for the set. |
+| Dimensions Height | `bricksetDimensionsHeight` | The packaging height in centimetres. |
+| Dimensions Width | `bricksetDimensionsWidth` | The packaging width in centimetres. |
+| Dimensions Depth | `bricksetDimensionsDepth` | The packaging depth in centimetres. |
+| Dimensions Weight | `bricksetDimensionsWeight` | The packaging weight in grams. |
+| Ean | `bricksetEan` | The set's EAN barcode. |
+| Upc | `bricksetUpc` | The set's UPC barcode. |
+| Retail Price (US) | `bricksetRetailPriceUs` | The US retail price in USD, as reported by LEGO.com. |
+| Retail Price (UK) | `bricksetRetailPriceUk` | The UK retail price in GBP, as reported by LEGO.com. |
+| Retail Price (CA) | `bricksetRetailPriceCa` | The Canadian retail price in CAD, as reported by LEGO.com. |
+| Retail Price (DE) | `bricksetRetailPriceDe` | The German retail price in EUR, as reported by LEGO.com. |
+| Last Updated | `bricksetLastUpdated` | When Brickset's data for this set was last updated. |
+| Product Description | `bricksetProductDescription` | Optional free-text product description, not part of Brickset's API output — typically bound from an expression composed of the other fields. Writes to a rich-text-editor property. |
+| Culture | — | Optional. Culture code (e.g. `en-US`) for variant content. Leave blank for invariant. Applies to every property written by this action. |
+| Segment | — | Optional. Segment for segmented content. Leave blank for the default segment. Applies to every property written by this action. |
+
+All fields above support `${ binding }` expressions.
+
+The action outputs the following, which can be referenced via bindings in later workflow steps:
+
+| Output | Description |
+|---|---|
+| ContentKey | The key of the content item that was targeted. |
+| Culture | The culture that was targeted (null for invariant). |
+| Segment | The segment that was targeted (null for the default segment). |
+| UpdatedPropertyAliases | The hardcoded property aliases that were actually written (only fields with a supplied value are included). |
+| SkippedPropertyAliases | The hardcoded property aliases that had a supplied value but were skipped because the content type doesn't have that property. |
+| NodeNameUpdated | Whether the content item's node name was changed. |
+
+If the content item does not exist, the action completes with a `notFound` outcome instead of failing.
+
 ## Compatibility
 
 | Package version | Umbraco Automate | Umbraco CMS |