notion-summary

This Skill automates uploading Claude session summaries and results to Notion pages by organizing content under date- and project-based subpages. It requires a NOTION_TOKEN environment variable, a configured ~/.agents/NOTION.md file, and the notion-upload.py script to publish summaries, file changes, and commands executed during your session.

Set up prerequisites by obtaining a Notion API token (NOTION_TOKEN), configuring your ~/.agents/NOTION.md file with Notion workspace settings, and ensuring the notion-client dependency is installed. Optional: specify a NOTION_PAGE_ID to define where session data uploads.

Yes. The Skill automatically creates and organizes documentation under date- and project-based subpages within your Notion workspace. Pass a project name via the --project flag when running notion-upload.py to categorize your session work.

The Skill uploads a structured record including the session summary (key intentions and decisions), list of generated or modified files, and executed commands. This documentation is stored in Notion under your specified project and date hierarchy.

Yes. The Skill uses the notion-client library to interact with the Notion API. The notion-client dependency is required; it handles all API communication for page creation and content publishing.

The Skill requires both NOTION_TOKEN and a properly configured ~/.agents/NOTION.md file to function. Without these, it cannot authenticate with Notion or determine where to upload your session data, and execution will fail.