notion:send-task-plan

Transfer Markdown plan files to a specified Notion page.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/ChanghwanK/dotfiles --skill notion-send-task-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion:send-task-plan
Source: https://github.com/ChanghwanK/dotfiles/tree/main/claude/.claude/skills/notion%3Asend-task-plan
Command: npx skills add https://github.com/ChanghwanK/dotfiles --skill notion-send-task-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of transferring task plans created in a specific format to Notion pages, streamlining collaboration and documentation sharing.

Core Features & Use Cases

  • Plan Transfer: Moves .md plan files from a local directory to a designated Notion page.
  • Collaboration: Facilitates sharing of design documents and plans with team members via Notion.
  • Use Case: After completing a detailed design document for a new feature, use this Skill to send the plan to a specific Notion page for review by your product manager and engineering lead.

Quick Start

Send the plan file located at ~/.claude/plans/feature-x.md to the Notion page with the URL https://www.notion.so/myworkspace/My-Feature-Page-1234abcd.

Frequently Asked Questions about notion:send-task-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a Markdown plan file to a specific Notion page?

To send a Markdown plan to Notion, you use a Python script that parses the Markdown into Notion blocks and transfers them to a specified Notion page using the page URL. This requires the NOTION_TOKEN environment variable for authentication.

Does the Markdown to Notion transfer support code blocks and nested lists?

Yes, the Markdown to Notion transfer supports parsing headings, lists, code blocks, and basic formatting into corresponding Notion blocks. It handles these elements to ensure your plan structure is maintained in the destination page.

What Notion URL formats are supported for page identification during the plan transfer?

The plan transfer supports various Notion URL formats for page identification. You can provide the direct link to the target Notion page, and the script will parse the URL to locate the correct destination for your Markdown content.

Do I need a Notion API token to automate transferring design documents?

Yes, you need the NOTION_TOKEN environment variable set for authentication to automate transferring design documents. This token allows the Python script to securely access your Notion workspace and append the parsed Markdown blocks.

Can I use this to share a local feature plan with my product manager for review?

Yes, you can transfer local design documents and plans to a designated Notion page for collaboration. This streamlines sharing the Markdown plan with your product manager and engineering lead directly in Notion.

What is the best way to automate moving task plans to a Notion workspace?

The best way to automate moving task plans to Notion is using a script that parses Markdown formatting into native Notion blocks. This approach preserves the structure of your local documents while seamlessly integrating them into your team's Notion workspace.