login
DonggangChen

notion_integration

by @DonggangChen in Productivity
2
2
# Install this skill:
npx skills add DonggangChen/antigravity-agentic-skills --skill "notion_integration"

Install specific skill from multi-skill repository

# Description

Notion workspace integration - knowledge management, meeting preparation, research documentation and spec-to-implementation workflows.

# SKILL.md

name: notion_integration
router_kit: FullStackKit
description: Notion workspace integration - knowledge management, meeting preparation, research documentation and spec-to-implementation workflows.
metadata:
skillport:
category: documentation
tags: [architecture, automation, best practices, clean code, coding, collaboration, compliance, debugging, design patterns, development, documentation, efficiency, git, notion integration, optimization, productivity, programming, project management, quality assurance, refactoring, software engineering, standards, testing, utilities, version control, workflow] - integration

πŸ“ Notion Integration

Comprehensive integration guide with Notion workspace.

πŸ“‹ Contents

  1. Knowledge Capture
  2. Meeting Intelligence
  3. Research Documentation
  4. Spec to Implementation

1. Knowledge Capture

Converting conversations and discussions into structured documentation.

Workflow

1. Extract content β†’ 2. Structure β†’ 3. Determine location β†’ 4. Create page β†’ 5. Link

Content Types

Type Structure
Concept Definition β†’ Features β†’ Examples β†’ Usage
How-To Prerequisites β†’ Steps β†’ Verification β†’ Troubleshooting
Decision Context β†’ Decision β†’ Rationale β†’ Consequences
FAQ Short Answer β†’ Detail β†’ Examples

Target Locations

  • Wiki page (general knowledge)
  • Project page (project specific)
  • Database (structured data)

2. Meeting Intelligence

Meeting preparation and document creation.

Workflow

1. Search in Notion β†’ 2. Fetch content β†’ 3. Enrich with Claude β†’ 4. Create pre-read β†’ 5. Create agenda

Document Types

Document Target Audience Content
Pre-Read Internal team Full context, metrics, strategic thoughts
Agenda All participants Goal, agenda, discussion topics

Meeting Types

  • Decision meeting: Options β†’ Proposal β†’ Discussion β†’ Decision
  • Status meeting: Progress β†’ Next work β†’ Blockers
  • Brainstorming: Goal β†’ Constraints β†’ Ideas β†’ Next steps

3. Research Documentation

Research and documentation in Notion workspace.

Workflow

1. Search β†’ 2. Fetch pages β†’ 3. Analyze β†’ 4. Synthesize β†’ 5. Create document

Output Formats

  • Research Summary: Short, focused findings
  • Comprehensive Report: Detailed analysis and recommendations
  • Quick Brief: Key points and actions

Best Practices

  1. Search broad, then narrow down
  2. Always link to sources
  3. Check currency
  4. Cross-verify

4. Spec to Implementation

Converting specifications into implementation plans.

Workflow

1. Find spec β†’ 2. Fetch and analyze β†’ 3. Create plan β†’ 4. Find task database β†’ 5. Create tasks β†’ 6. Progress tracking

Spec Analysis

Type Content
Functional User stories, features, data requirements
Non-Functional Performance, security, scalability
Acceptance Criteria Testable conditions, benchmarks

Task Breakdown Patterns

  • By Component: DB, API, Frontend, Test
  • By Feature: Vertical slices (auth, data entry)
  • By Priority: P0, P1, P2

πŸ”§ Common Tools

Notion:notion-search     β†’ Search page/database
Notion:notion-fetch      β†’ Fetch content
Notion:notion-create-pages β†’ Create page
Notion:notion-update-page  β†’ Update page

Notion Integration v1.1 - Enhanced

πŸ”„ Workflow

Source: Notion API Documentation

Phase 1: Integration Design

  • [ ] Capabilities: Set integration capabilities (Read/Update/Insert/Comment) with Least Privilege principle.
  • [ ] Database ID: Store target database IDs as environment variables.
  • [ ] Mapping: Map external data model to Notion properties (Rich Text, Select, Date).

Phase 2: Robust Operations

  • [ ] Rate Limiting: Notion API limits to 3 requests per second. Establish retry mechanism with Exponential Backoff.
  • [ ] Pagination: Don't forget to use next_cursor when fetching more than 100 records.
  • [ ] Rich Text: Handle Markdown -> Notion Block conversion correctly (paragraphs, lists, headings).

Phase 3: Maintenance

  • [ ] Orphaned Content: Periodically check for pages that should be deleted but are not accessible via API (Trash).
  • [ ] Webhooks: Optimize polling interval to detect data changes instantly (if no official webhook).

Checkpoints

Phase Verification
1 Are Notion queries compatible with property types (Select vs Multi-select)?
2 Is 429 (Too Many Requests) error managed correctly?
3 Is page content (Block children) hierarchy transferred without corruption?

# Related Skills

moltbot
obsidian @moltbot

Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.

β˜… 65,001

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚑ Amp πŸš€ Antigravity πŸ€– Claude Code πŸ¦€ Clawdbot πŸ“ Codex ▢️ Cursor πŸ€– Droid πŸ’Ž Gemini CLI πŸ™ GitHub Copilot πŸͺΏ Goose πŸ“Š Kilo Code πŸ”§ Kiro CLI πŸ’» OpenCode 🦘 Roo Code 🌲 Trae πŸ„ Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.