SkillNarrative Common
Register Snowflake Dataset
Register a Snowflake table or view as a Narrative dataset from SQL, and confirm it is active.
About
Overview
Register a Snowflake table or view as a Narrative dataset from SQL, without the native app's Configuration screen. Resolves the installed Narrative app and the source object, checks the app has a warehouse, shows the exact CALL for approval, registers the object, and reports success only once the dataset's mapping row exists and the platform reports it active. Every registration is reported with the statement that undoes it.
Not for installing or configuring the native app, or for querying a dataset that already exists.
Skill Support
Specifications
- Plugin
- Narrative Common
- Runtime
- Prompt + code
- Version
- 0.1.0
- Languages
- SQL
- Required Tools
- Bash
- Included Files
- SKILL.md
Arguments
| Argument | Required / Default | Description |
|---|---|---|
--object <db.schema.name> | Optional | Fully qualified source table or view. If omitted, the skill asks. |
--display-name <text> | Optional | Dataset name on the platform. Must be unique among registered datasets. If omitted, the skill asks — it is never invented. |
--machine-name <text> | Optional | The dataset's machine name. Optional; Snowflake defaults it to the display name with every character that is not a letter, number or underscore replaced by an underscore. |
--description <text> | Optional | Free text stored on the dataset. Omitted when not supplied. |
--app <application> | Default: NARRATIVE_DATA_COLLABORATION | The installed native app. Verified before use; discovered with SHOW APPLICATIONS only when the default does not resolve. |
Example prompts
| Prompt | When to use it |
|---|---|
Register ANALYTICS.PUBLIC.CUSTOMERS as a dataset | Turn a Snowflake table into a Narrative dataset without opening the Configuration screen. |
Add this view to my data plane | Register a view that projects only the columns Narrative supports. |
/register-snowflake-dataset --object ANALYTICS.PUBLIC.ORDERS --display-name "Orders" --description "Daily order feed" | Script a registration with the object, name and description given up front. |
Installation
Install into any spec-compliant agent — no clone or Bun required:
npx skills add narrative-io/narrative-skills-marketplace