skill CX Codex

sync · makenotion — Claude Code skill: Notion App database syncs

Q: How do I install sync in Claude Code?

Run `npx skills add makenotion/notion-cookbook --skill sync -a claude-code`. The skill lands at `~/.claude/skills/sync/SKILL.md`.

Q: What does the sync skill do?

It makes the agent read `node_modules/@notionhq/apps/skills/sync/SKILL.md` before touching any Notion App sync code, then work from the instructions in that file.

Q: Why can't I invoke the skill by name?

It is marked `user-invocable: false`, so it triggers on its own when a task involves database syncs. No slash command exists for it.

Guides an agent through writing, debugging and reviewing Notion App database syncs, with stable keys and pagination you can resume.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add makenotion/notion-cookbook --skill sync -a claude-code

Open on GitHub

What sync does

The skill fires when you build, change or troubleshoot code that syncs Notion App databases. It does no work itself. Instead it tells the agent to read node_modules/@notionhq/apps/skills/sync/SKILL.md, resolved against the App project root, and then follow what that file says.

If the path is empty, the skill points at installing the project dependencies. Still nothing there? Updating @notionhq/apps to a release that ships the skill is the next step. Sync edits wait until the SDK skill can be read — otherwise the agent is guessing at the API.

There is no slash command. The description carries user-invocable: false, so the agent picks the skill up on its own once your request touches database syncs. Describe the task and let it trigger.

What it helps with

write a Notion App database sync from scratch
fix pagination that drops records mid-run
track down keys that shift between sync runs
review someone else's sync code before merging
bump @notionhq/apps to a release that includes the SDK skill

Example prompts for the agent

Write a Notion App database sync with stable keys and resumable pagination.
Why do records duplicate on the second sync run?
Review the sync code in src/sync.ts before I merge.

How to install sync

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill sync -a claude-code

2Manually: put the files in place

~/.claude/skills/sync/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sync/

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill sync -a codex

2Manually: put the files in place

.agents/skills/sync/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill sync -a cursor

2Manually: put the files in place

.cursor/skills/sync/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install makenotion/notion-cookbook sync

2Manually: put the files in place

.github/skills/sync/SKILL.md

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill sync -a gemini-cli

2Platform CLI

gemini skills install https://github.com/makenotion/notion-cookbook --path apps/agents/skills/sync

Manually: put the files in place

.devin/skills/sync/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill sync -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sync

How do I install sync in Claude Code?

Run npx skills add makenotion/notion-cookbook --skill sync -a claude-code. The skill lands at ~/.claude/skills/sync/SKILL.md.

What does the sync skill do?

It makes the agent read node_modules/@notionhq/apps/skills/sync/SKILL.md before touching any Notion App sync code, then work from the instructions in that file.

Why can't I invoke the skill by name?

It is marked user-invocable: false, so it triggers on its own when a task involves database syncs. No slash command exists for it.

Source text

SKILL.md · MIT

---
name: sync
description: Build, debug, or review Notion App database syncs with stable keys and resumable pagination.
user-invocable: false
---

# App database syncs

Before creating, modifying, or troubleshooting sync code, read
`node_modules/@notionhq/apps/skills/sync/SKILL.md`.
Resolve this path relative to the App project root.
Follow the instructions in that file.

If the file is missing, install the project dependencies.
If it remains missing, update `@notionhq/apps` to a release that includes the skill.
Do not continue with sync changes until you can read the SDK skill.

sync by other authors comes first.

sync jsmastery-pro A skill that brings AGENTS.md, the scope and spec status lines back in line with what the repo shows after a change. Runs in Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode. CX Codex +1 4,300installs sync iurykrieger Re-reads the external sources behind vault entities, diffs them against what is stored and hands the changes off for writing. Useful when your notes have drifted from Confluence, GDocs or GitHub. CX Codex +1 ★ 108repo stars context-sync Intina47 A local memory layer for a codebase: the agent keeps decisions, constraints and file structure across sessions. Handy when context vanishes on restart. CX Codex +1 ★ 189repo stars notion openclaw This skill connects an agent to Notion through the ntn CLI and API, for reading and editing pages, querying data sources, and uploading files. CX Codex +1 5,600installs notion-automation claude-office-skills Automates Notion databases and page templates with cross-platform triggers. Useful for handling leads, task digests, and calendar events. CX Codex +1 4,800installs data-scraper-agent affaan-m This skill walks you through building an agent that scrapes public sources on a schedule, enriches results with Gemini Flash, and stores them in Notion, Sheets or Supabase. CX Codex +1 4,600installs database-query makenotion This skill finds a Notion database by name or ID and returns matching rows as a compact table, applying filters and sorting you describe in plain words. CX Codex +1 ★ 38repo stars Database Sync Claude Office Skills A skill for database synchronization: replication, schema migration and data movement across PostgreSQL, MySQL, MongoDB and Redis. Useful when two stores need to stay in step. CX Codex +1 4,600installs

From the same set7

workflow-validate Walks through src/workflows/ and flags trigger typing mistakes and retry hazards. Useful before a workflow ships. CX Codex +1 ★ 220repo stars sync-validate This skill walks through your sync code and flags the usual failure points: a cursor that never moves, pagination that never ends, dropped deletes. CX Codex +1 ★ 220repo stars custom-blocks Walks you through building an interactive UI inside Notion that reads and writes workspace data. CX Codex +1 ★ 220repo stars custom-blocks A skill that routes your agent through the Notion App SDK docs before it touches custom block code. Useful when a project has interactive browser blocks. CX Codex +1 ★ 220repo stars notion-spec-to-implementation Turns Notion specs into implementation plans, linked tasks, and progress reports backed by evidence. Handy when requirements need to become work without losing acceptance criteria. CX Codex +1 ★ 220repo stars notion-knowledge-capture Turns a conversation or supplied notes into Notion pages: wiki entries, how-to guides, FAQs, decision records and retrospectives. Handy when agreements and details must survive the chat. CX Codex +1 ★ 220repo stars