SkillNarrative Common

Apply Rosetta Stone Mappings

Apply generated Rosetta Stone mappings to a dataset via a one-shot, approval-gated workflow.

About

Overview

Apply a set of Rosetta Stone attribute mappings to a Narrative dataset by wrapping them in a one-shot workflow that calls the CreateRosettaStoneMappingsIfNotExist task. Consumes the structured output of Generate Rosetta Stone Mappings, re-validates every expression against the current schema, gates on user approval, submits the workflow, polls the run, and reports per-mapping created / conflict / failed.

Rosetta StoneMappingsWorkflowProductionize

Skill Support

Specifications

Plugin: Narrative Common
Runtime: Prompt + code
Version: 0.3.0
Languages: NQL
Required Tools: Read, narrative_datasets_describe, narrative_nql_validate, narrative_workflows_create, narrative_workflow_runs_list
Included Files: SKILL.md

Arguments

Argument	Required / Default	Description
`--dataset <id\|name>`	Optional	The target dataset's numeric ID or its datasetName (alphanumerics + underscores). Required before submission; if omitted, the skill asks.
`--from <path>`	Optional	Path to a JSON file containing the mappings input (see references/INPUT_FORMAT.md). Mutually exclusive with --mappings.
`--mappings <json>`	Optional	Inline JSON string with the mappings input. Useful when invoked programmatically from /generate-rosetta-stone-mappings.
`--allow-partial / --no-allow-partial`	Default: true	Sets the task's allowPartial flag — when true, individual mapping failures don't abort the others.
`--data-plane <id>`	Optional	UUID of the data plane to target. Skips data-plane resolution.
`--dry-run`	Optional	Render the full spec, re-validation results, and the create-call parameters; do NOT submit. Implies --show-spec.
`--show-spec`	Optional	Include the full rendered workflow YAML in the approval preview. Off by default — most users only need the plain-English summary.
`--no-trigger`	Optional	Submit the workflow but do not pass trigger_immediately: true. The user must trigger it manually later (rare).
`--no-revalidate`	Optional	Skip Phase 5 NQL re-validation. Intended for same-conversation hand-off from /generate-rosetta-stone-mappings. Do NOT pass when the input is from a file, a paste, or a prior conversation — the schema may have drifted.

Example prompts

Prompt	When to use it
`Apply the mappings I just generated to dataset 123`	Productionize a reviewed mapping set via a one-shot, approval-gated workflow.
`Create the sha256_hashed_email mapping on this dataset`	Push a single approved mapping to a dataset and confirm it was created.
`Productionize this mapping list`	Submit the suggested_mappings array and get a per-mapping created / conflict / failed report.
`/apply-rosetta-stone-mappings --dataset 123 --dry-run`	Preview the rendered spec and re-validation results for dataset 123 without submitting anything.