skill

custom-blocks

Build interactive browser custom blocks declared by a Notion App.

makenotion/notion-cookbook/apps/agents/skills/custom-blocksofficiallistedunreviewednot running here yet

Set up

Skills are installed by placing their folder where your agent loads skills.

Part of the collection makenotion/notion-cookbook.

npx skills add makenotion/notion-cookbook --skill custom-blocks

Or by hand: Copy the folder apps/agents/skills/custom-blocks from github.com/makenotion/notion-cookbook into ~/.claude/skills/custom-blocks/ (Claude Code) or your agent's skills folder. Check the collection's own README for other agents.

README

synced Oct 14, 2026

App custom blocks

Before creating, modifying, or troubleshooting custom block code, read node_modules/@notionhq/apps/skills/custom-blocks/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 custom block changes until you can read the SDK skill.