$git clone https://github.com/tommy-ca/notion-skillsClaude Skills marketplace for productive Notion workflows: knowledge capture, meeting intelligence, research documentation, and spec-to-implementation planning
| 1 | # Notion Skills - Claude Plugins Marketplace |
| 2 | |
| 3 | A comprehensive marketplace of Claude skills for productive Notion workflows. Transform how you work with Notion by leveraging AI-powered assistance for knowledge capture, meeting intelligence, research documentation, and specification implementation. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | Notion Skills provides four specialized, autonomous Claude skills that integrate seamlessly with Notion: |
| 8 | |
| 9 | - **Knowledge Capture** - Transform conversations and discussions into structured Notion documentation |
| 10 | - **Meeting Intelligence** - Prepare for meetings with comprehensive context, agendas, and background materials |
| 11 | - **Research Documentation** - Conduct research and document findings with proper sourcing and organization |
| 12 | - **Spec-to-Implementation** - Convert specifications into detailed implementation plans with task tracking |
| 13 | |
| 14 | These skills automatically activate when relevant to your task, enhancing productivity without requiring explicit invocation. |
| 15 | |
| 16 | ## Project Structure |
| 17 | |
| 18 | ``` |
| 19 | notion-skills/ |
| 20 | ├── .claude-plugin/ |
| 21 | │ ├── marketplace.json # Marketplace registry |
| 22 | │ └── plugin.json # Root plugin metadata (deprecated) |
| 23 | ├── .gitignore |
| 24 | ├── CLAUDE.md # Claude Code integration guide |
| 25 | ├── README.md # This file |
| 26 | ├── plugins/ |
| 27 | │ └── notion-skills/ |
| 28 | │ ├── .claude-plugin/ |
| 29 | │ │ └── plugin.json # Notion Skills plugin metadata |
| 30 | │ ├── skills/ |
| 31 | │ │ ├── knowledge-capture/ |
| 32 | │ │ │ ├── SKILL.md # Skill definition |
| 33 | │ │ │ ├── reference/ # Templates and guides |
| 34 | │ │ │ ├── evaluations/ # Test scenarios |
| 35 | │ │ │ └── examples/ # Usage examples |
| 36 | │ │ ├── meeting-intelligence/ |
| 37 | │ │ ├── research-documentation/ |
| 38 | │ │ └── spec-to-implementation/ |
| 39 | │ ├── agents/ # (Optional) Custom agent definitions |
| 40 | │ ├── commands/ # (Optional) Slash commands |
| 41 | │ ├── CLAUDE.md # Plugin-specific integration guide |
| 42 | │ └── README.md # Plugin-specific documentation |
| 43 | ├── LICENSE |
| 44 | └── CONTRIBUTING.md |
| 45 | ``` |
| 46 | |
| 47 | ## Installation |
| 48 | |
| 49 | ### Via Claude Code Plugin System |
| 50 | |
| 51 | ```bash |
| 52 | # Clone the repository to your Claude plugins directory |
| 53 | git clone https://github.com/tommy-ca/notion-skills.git \ |
| 54 | ~/.claude/plugins/notion-skills |
| 55 | |
| 56 | # Restart Claude Code |
| 57 | # Skills will automatically load and become available |
| 58 | ``` |
| 59 | |
| 60 | ### Manual Setup |
| 61 | |
| 62 | 1. Copy the `notion-skills` directory into `~/.claude/plugins/` |
| 63 | 2. Restart Claude Code |
| 64 | 3. Configure Notion API token (see Configuration section) |
| 65 | |
| 66 | ## Configuration |
| 67 | |
| 68 | ### 1. Get Notion API Token |
| 69 | |
| 70 | 1. Visit [Notion Developer Portal](https://www.notion.so/my-integrations) |
| 71 | 2. Click "Create new integration" |
| 72 | 3. Fill in integration details |
| 73 | 4. Copy your API token |
| 74 | |
| 75 | ### 2. Share Notion Databases |
| 76 | |
| 77 | For each database you want the skills to access: |
| 78 | |
| 79 | 1. Open the database in Notion |
| 80 | 2. Click "Share" button |
| 81 | 3. Select your integration |
| 82 | 4. Grant "Edit" permissions |
| 83 | |
| 84 | ### 3. Set Environment Variable |
| 85 | |
| 86 | ```bash |
| 87 | export NOTION_API_TOKEN=your_token_here |
| 88 | ``` |
| 89 | |
| 90 | Or configure in Claude Code settings for persistent storage. |
| 91 | |
| 92 | ## Available Skills |
| 93 | |
| 94 | ### 1. Knowledge Capture |
| 95 | |
| 96 | Transform conversations into structured documentation. |
| 97 | |
| 98 | **Activates when you:** |
| 99 | - Ask to organize meeting notes |
| 100 | - Want to document a discussion |
| 101 | - Need to extract decisions and action items |
| 102 | - Wish to create knowledge base articles |
| 103 | |
| 104 | **Example:** |
| 105 | ``` |
| 106 | "Document this discussion in Notion with decisions and action items" |
| 107 | → Knowledge Capture activates |
| 108 | → Creates meeting summary with clear structure |
| 109 | ``` |
| 110 | |
| 111 | **Outputs:** |
| 112 | - Meeting summaries with action items |
| 113 | - Decision records with rationale |
| 114 | - FAQ documents from discussions |
| 115 | - Learning documents from experiences |
| 116 | - Process documentation |
| 117 | |
| 118 | **More Info:** See `plugins/notion-skills/skills/knowledge-capture/` |
| 119 | |
| 120 | --- |
| 121 | |
| 122 | ### 2. Meeting Intelligence |
| 123 | |
| 124 | Prepare for productive meetings with comprehensive context. |
| 125 | |
| 126 | **Activates when you:** |
| 127 | - Ask to prepare for an upcoming meeting |
| 128 | - Want to gather context on a topic |
| 129 | - Request a comprehensive meeting agenda |
| 130 | - Need background materials for participants |
| 131 | |
| 132 | **Example:** |
| 133 | ``` |
| 134 | "Help me prepare for my 2pm meeting with the product team" |
| 135 | → Meeting Intelligence activates |
| 136 | → Gathers relevant context, creates agenda |
| 137 | ``` |
| 138 | |
| 139 | **Outputs:** |
| 140 | - Meeting agendas with timing |
| 141 | - Background context gathered from Notion |
| 142 | - Pre-read materials |
| 143 | - Discussion talking points |
| 144 | - Risk/blocker identification |
| 145 | |
| 146 | **More Info:** See `plugins/notion-skills/skills/meeting-intelligence/` |
| 147 | |
| 148 | --- |
| 149 | |
| 150 | ### 3. Research Documentation |
| 151 | |
| 152 | Document research findings with proper sourcing. |
| 153 | |
| 154 | **Activates when you:** |
| 155 | - Ask to research a specific topic |
| 156 | - Want to document research findings |
| 157 | - Request competitive or market analysis |
| 158 | - Need to create a literature review |
| 159 | |
| 160 | **Example:** |
| 161 | ``` |
| 162 | "Research React vs Vue frameworks and document findings in Notion" |
| 163 | → Research Documentation activates |
| 164 | → Conducts research, creates sourced summary |
| 165 | ``` |
| 166 | |
| 167 | **Outputs:** |
| 168 | - Quick brie |