notion

name	notion
description	Update Notion pages with strategic and organizational context from the current session by dispatching the up-docs-propagate-notion sub-agent. This skill should be used when the user runs /up-docs:notion.
allowed-tools	Read, Bash, Agent

/up-docs:notion

Update Notion via the up-docs-propagate-notion sub-agent (Sonnet).

Workflow

1. Gather Session Context

First, verify Python 3 is available — all helper scripts depend on it:

command -v python3 >/dev/null 2>&1 || { echo "ERROR: python3 not found in PATH — install python3 and retry."; exit 1; }
bash ${CLAUDE_PLUGIN_ROOT}/scripts/context-gather.sh

Combine with conversation history.

2. Build the Session-Change Summary

Read ${CLAUDE_PLUGIN_ROOT}/templates/session-change-summary.md for the canonical format. Produce a concrete summary following that template. Focus on strategic/organizational items — what exists, why, who depends on it, status changes. The sub-agent filters further on its own (config values never propagate to Notion).

3. Dispatch up-docs-propagate-notion

Invoke the sub-agent via the Agent tool with subagent_type: "up-docs:up-docs-propagate-notion" (the up-docs: prefix is required — plugin-defined agents are only addressable through their plugin namespace). Put the session-change summary at the stable front of the prompt; add Notion-specific context (CLAUDE.md ## Documentation Notion mapping, if present) at the end.

Notion content guidelines (tone, structure, layer boundaries) live in the sub-agent's system prompt — you do not need to attach anything separately.

4. Pass the Sub-agent's Output Through

The sub-agent returns a markdown table conforming to templates/summary-report.md single-layer "Notion" format. Emit it as the skill's final output.

If the sub-agent fails entirely, report a single-row table noting the failure with a one-sentence reason.

Notes

• This skill no longer fetches pages or writes updates directly. That work happens inside the sub-agent.
• Layer boundaries (Notion = strategic/organizational; no configs, no commands, no procedures) are inlined in the sub-agent's system prompt.