reading-notion

syou6162's avatarfrom syou6162

Notion URLが会話に登場した時、またはNotionのコンテンツを検索・取得する必要がある時に使用してください。

⭐9stars🔀0forks📁View on GitHub🕐Updated Nov 25, 2025

When & Why to Use This Skill

This Claude skill enables seamless integration with Notion, allowing the agent to search, retrieve, and summarize workspace content directly. By converting Notion pages into Markdown format, it preserves document structure and rich block types, making it easier to extract insights from internal documentation, project notes, and team wikis.

Use Cases

  • Instant Document Summarization: Provide a Notion URL to get a concise summary of project specifications, meeting minutes, or research papers without leaving the chat.
  • Internal Knowledge Retrieval: Search your team's Notion workspace using keywords to find specific information about company policies, onboarding guides, or technical documentation.
  • Contextual Data Extraction: Automatically fetch and analyze structured data from Notion pages to answer complex questions based on your private or team knowledge base.
  • Markdown Conversion for Documentation: Convert complex Notion pages into clean Markdown for use in code repositories, technical blogs, or cross-platform documentation workflows.
namereading-notion
descriptionNotion URLが会話に登場した時、またはNotionのコンテンツを検索・取得する必要がある時に使用してください。
allowed-toolsBash, Read

Reading Notion

NotionページやドキュメントをMarkdownに変換して読み取り、内容を要約・説明するスキルです。

概要

このスキルは2つのモードで動作します:

  1. URL直接モード: Notion URLが会話に登場した時、notion-to-mdを使って自動的にMarkdownに変換し、内容を説明
  2. 検索モード: キーワードでNotionを検索し、結果から選択したページの内容を説明

URL直接モードでは、Go製のCLIツールnotion-to-mdを使用してNotion APIからページデータを取得し、Markdown形式に変換します。これにより、ネスト構造、豊富なブロックタイプ、テキストアノテーションなどを正確に保持したMarkdownファイルが生成されます。

モード詳細

URL直接モード

Notion URLを検出すると自動的に発動します。詳細は reference/url-mode.md を参照してください。

発動例:

  • ユーザーが https://www.notion.so/myorg/abc123def456ghi789jkl012mno34567 のようなURLを提示
  • 会話中にNotion URLが登場

検索モード

キーワードでNotion内を検索したい時に発動します。詳細は reference/search-mode.md を参照してください。

発動例:

  • 「データ基盤チームについて教えて」
  • 「Notionでプロジェクト〇〇を検索して」
  • 特定のキーワードに関する情報を求められた時