Hub for getting started with Notion, including documentation, customizable scripts, and quick-start guides.
Install
npx skills add makenotion/notion-cookbookgh skill install makenotion/notion-cookbookgit clone --depth 1 https://github.com/makenotion/notion-cookbookSkills in this collection
- Auth GuideNotionOfficialGuide to setting up third-party authentication for a Notion Worker. Covers brokered credentials for external-service API keys / personal access tokens, OAuth, and plaintext environment secrets only when worker code needs the value. Use when the worker needs credentials for a non-Notion API, not for Notion API tokens or `ntn login`.
- ConnectionsNotionOfficialConfigure and use typed provider connections and connection-bound triggers in Notion App workflows.
- Custom BlocksNotionOfficialBuild interactive browser custom blocks declared by a Notion App.
- Custom BlocksNotionOfficialCreate, modify, and troubleshoot custom blocks in Notion Workers. Use when the user wants to build interactive UI inside Notion connected to Notion data. Covers the author workflow from project setup to local preview and deployment.
- Notion As CodeNotionOfficialDeclare Notion pages, databases, teamspaces, and custom agents in an App, including data sources used by syncs.
- Notion Database DesignerNotionOfficialTurns scattered notes and recurring work into useful Notion trackers for requests, content plans, or team work. Use to set up or improve a tracker, choosing its fields and views from the user's needs; ordinary record updates belong to the task's workflow.
- Notion Knowledge CaptureNotionOfficialCaptures conversations and supplied notes as Notion wiki pages, how-to guides, FAQs, decision records, or retrospectives. Use when saving or updating durable knowledge from existing context; use research-documentation when new source discovery and synthesis is the main task.
- Notion Meeting IntelligenceNotionOfficialPrepares meeting agendas, internal pre-reads, and decision briefs using Notion context and relevant research. Use for meeting preparation, recurring meeting context, or updating meeting outcomes; use knowledge-capture for a standalone record of an existing discussion.
- Notion Research DocumentationNotionOfficialResearches questions across Notion sources and synthesizes cited briefs, comparisons, or reports. Use when answering requires discovering and reconciling workspace information, optionally with external research, and returning or saving the findings.
- Notion Spec To ImplementationNotionOfficialConverts Notion product or technical specs into implementation plans, linked tasks, and evidence-based progress updates. Use for planning or implementing a spec, creating tasks from requirements, or reconciling implementation with spec changes.
- Notion Weekly Project DigestNotionOfficialProduces evidence-based weekly project or team updates by comparing reporting periods, tasks, decisions, and blockers in Notion. Use for recurring status digests; use spec-to-implementation for requirement-level implementation tracking.
- SketchNotionOfficialSketch an App workflow as a reviewable flow diagram when planning or iterating on its design with the user.
- SyncNotionOfficialBuild, debug, or review Notion App database syncs with stable keys and resumable pagination.
- SyncNotionOfficialScaffold a new sync capability with guided setup — asks about data source, mode, pagination, and cursor design, then generates working code
- Sync DebugNotionOfficialDiagnose a failing or misbehaving sync — fetch run logs, identify errors, cross-reference with code, and suggest fixes
- Sync GuideNotionOfficialComprehensive guide to building Notion Workers syncs — covers the two-sync architecture (backfill+delta), replace mode, pagination, consistency buffers, pacers, deletion strategies, and common pitfalls. Auto-loads when sync-related work is detected.
- Sync ValidateNotionOfficialReview a sync capability for common bugs — cursor advancement, pagination termination, state persistence, bi-modal correctness, consistency buffers, and deletion handling
- WorkflowNotionOfficialBuild or review Notion App workflows for typed triggers, durable replay-safe steps, and idempotent effects.
- WorkflowNotionOfficialScaffold a Notion Worker Workflow with typed triggers and replay-safe durable steps.
- Workflow GuideNotionOfficialReference for typed triggers, durable steps, replay-safe data flow, and idempotent Workflow effects.
- Workflow ValidateNotionOfficialReview Notion Worker Workflows for trigger typing and retry safety.