Setup Notion

---
name: setup-notion
description: First-time setup of the Notion training workspace. Use when the user asks to set up Notion, get started, create their training log, or when other skills find the workspace databases do not exist yet.
---

# Set up the Notion training workspace

Build the full coaching workspace under the user's Hub page: the Programs, Goals,
Body Stats, and Workout Log databases, an initial program row, and a Dashboard
page. This is deterministic and idempotent, handled by a bundled script.

## 1. Check configuration

Notion is reached with the integration token in `NOTION_TOKEN`, and the Hub page
is `NOTION_PARENT_PAGE_ID`. If `NOTION_TOKEN` is missing, tell the user plainly:
they need to set it and share a page with the integration, then try again. Do not
pretend it worked. If `NOTION_PARENT_PAGE_ID` is missing, ask the user to share a
page with the integration and tell you its name, find it, and pass it as `--hub`.

## 2. Build the workspace

Run the builder via Bash:

```bash
node scripts/setup-workspace.mjs
# or, if the Hub id is not in the environment:
node scripts/setup-workspace.mjs --hub <pageId>
```

It builds in the strict order the relations require (Programs, Goals, Body Stats,
Workout Log, initial program row, Dashboard), detects anything that already
exists by title and reuses it (never duplicates), and writes all resolved ids
(databases, Dashboard page, and the Dashboard column ids for tile updates) to
`data/notion-ids.json`. To regenerate the Dashboard layout, add
`--rebuild-dashboard`.

The full schema and API patterns are documented in `docs/notion-architecture.md`;
read it if you need to extend the workspace.

## 3. Seed goals and confirm

If `PERSONAL.md` lists real goals, offer to add them to the Goals database (ask
before writing), and refresh the Dashboard Goals tile afterwards (see the
notion-formatting skill). Then confirm what now exists and tell the user they can
log workouts in plain language and ask for plans, recommendations, and progress.

## Note on views

Notion's public API cannot create or configure database views (grouping, default
filters). After setup, tell the user to set any default view by hand once in
Notion; it cannot be done programmatically.