Notion Manual Import

What it is: the Notion step for every module - a CSV, a property mapping and the click-path to import, for a user who will upload the database themselves. Any module that gets a selected Notion output routes that step here, so the mapping and the import steps exist in exactly one place.

Overview

Prepares a database so the user can upload it into Notion by hand. It handles the confirmed fields, the CSV, the Notion property mapping, select and status options, the manual import steps, and the post-import verification.

This is a helper: it defines no table of its own and renders whatever field list the active module already confirmed, so its CSV and mapping are derived, never re-invented. It is the Notion workflow, not a consolation prize - the module confirms the fields and hands the Notion step to this file.

Manual outputs need no workspace connection. A requested live build uses the shared contract to verify available tools and the destination before making changes.

Layer: n/a. Fits: every stage. Table code: n/a - it renders the active module's table.

When to Use This Skill

• upload this to Notion
• give me a Notion template
• I will upload it manually
• create a CSV for Notion
• give me Notion import instructions
• Notion is not connected
• set this up in Notion
• make this Notion-ready
• show me how to create this database manually

Use it whenever the user selects Notion as an output, whatever module is active. Also use it when another skill produces a database structure but direct Notion creation is unavailable, or whenever the user requests a manual route.

This helper owns the mapping for both manual output and an authorized connected build.

How It Works

Follow the shared execution contract. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.

Step 1 - Identify intent

Read the request and pick the intent before asking anything.

• "I will upload it myself", "Notion is not connected", "show me how" -> manual setup; go to Step 2.
• "just give me the CSV" -> import file only. Output: CSV alone.
• "I already have the CSV, what do I set" -> mapping only. Output: property mapping alone.
• "it imported but everything is Text" -> fix existing import. Output: correction instructions for the properties that are wrong, and nothing else unless asked.
• "Notion connected" -> verify tool access. Continue a previously requested workspace build only if the required tools and destination are available; otherwise explain the blocker.

Never rebuild everything when a correction is what was asked for.

Step 2 - Ask only what is missing

Skip anything the user already answered, in any earlier message, including answers given to the module skill that owns the field list. Reuse the database name, the field names and types, the select options, the statuses, the relations, the currency fields, the date fields and the IDs. Never ask for information the user has already provided.

Ask one short question per message, and only when the answer changes the output:

Q: Do you want an empty template or example rows?

If it does not materially change the requested output, do not ask, and default to no example rows:

example_rows: false

Step 3 - Hold the internal context

Hold the answers in this shape. It stays internal - it is not shown to the user unless they ask, and it never carries a value the user did not give.

module: notion-manual-import
intent: null              # set in Step 1, one of: manual setup, import file, mapping, fix
source_module: null       # the module whose field list this renders
notion_connected: null    # true | false | unknown - never assumed either way
requested_outputs: []     # csv | mapping | instructions | verification
example_rows: false
confirmed_facts: []       # only what the user actually said
open_questions: []        # the unanswered ones, in the order worth asking

source_module is the only field this skill needs that a module skill does not have. If it is unknown, ask which database to prepare, because a CSV without a confirmed field list is a guess.

Step 4 - Recommend the smallest workflow

Produce an already requested output without asking again. For advice-only requests, give a short recommendation and offer the relevant output.

Recommended approach: One CSV with a header of the exact field names, one property

…