flatten_skill

Overview

This skill merges all items of a Collection into a single Note. It takes a Collection as input and returns one Note whose content is the concatenation of the Collection items. It is designed as the inverse operation of a split workflow and preserves content by merging, not by preserving original collection structure.

How this skill works

You pass a Collection (by variable or ID) as the target and provide an output variable name. The skill iterates the collection items and concatenates their content into a single Note, then writes that Note to the specified output variable. If the target is not a Collection or required parameters are missing, the skill returns a failure status.

When to use it

• You need a single note that consolidates several collection items for export or display.
• Preparing a combined summary or report from multiple entries.
• When reversing a previous split operation to restore a single-note form.
• Merging fragmented content before running text-level processing or publishing.

Best practices

• Ensure the input target is a Collection; pass Notes through split first if needed.
• Choose a clear output variable name to avoid overwriting existing data.
• Expect merged content to lose collection-level structure (no guaranteed fieldwise merging).
• Validate the resulting Note if downstream processing requires specific structure.

Example use cases

• Flatten a task collection into a single meeting agenda note for sharing.
• Combine daily journal entries (stored as a Collection) into a single monthly summary Note.
• Restore a Note that was previously split into multiple items for granular editing.
• Merge multiple content blocks into one Note before generating a PDF or export.