skill CX Codex

notion-as-code — Claude Code skill: what it does, how to install

Q: How do I install notion-as-code in Claude Code?

Run `npx skills add makenotion/notion-cookbook --skill notion-as-code -a claude-code`. The skill file is installed at `~/.claude/skills/notion-as-code/SKILL.md`.

Q: Which file must the agent read before changing Notion as Code?

It must read `node_modules/@notionhq/apps/skills/notion-as-code/SKILL.md` relative to the App project root. If the file is missing, install project dependencies; if it remains missing, update `@notionhq/apps` to a release that includes the skill.

This skill sets a prerequisite for Notion as Code work in an App: the agent must read the SDK skill before making changes. It also covers troubleshooting.

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

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

Open on GitHub

What notion-as-code does

The skill guides work on Notion as Code in an App. The project description says this approach can declare Notion pages, databases, teamspaces, custom agents, and data sources used by syncs.

Before creating, editing, or troubleshooting this code, the agent must read node_modules/@notionhq/apps/skills/notion-as-code/SKILL.md, resolved from the App project root. If the file is missing, install the project dependencies. If it still cannot be found, update @notionhq/apps to a release that includes the SDK skill. Changes must wait until the instructions are readable. So this workflow depends on the SDK skill being present.

What it helps with

Declare Notion pages in an App
Define databases and teamspaces
Add custom agents
Specify data sources for syncs

Example prompts for the agent

Review the Notion as Code in my App and follow the SDK skill.
Add a Notion database declaration to the App using the skill instructions.
Troubleshoot this Notion as Code implementation before changing it.

How to install notion-as-code

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/notion-as-code/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/notion-as-code/

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill notion-as-code -a codex

2Manually: put the files in place

.agents/skills/notion-as-code/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill notion-as-code -a cursor

2Manually: put the files in place

.cursor/skills/notion-as-code/SKILL.md

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

1GitHub CLI

gh skill install makenotion/notion-cookbook notion-as-code

2Manually: put the files in place

.github/skills/notion-as-code/SKILL.md

1Skills CLI (Vercel)

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

2Platform CLI

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

Manually: put the files in place

.devin/skills/notion-as-code/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add makenotion/notion-cookbook --skill notion-as-code -a opencode

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

Questions about notion-as-code

How do I install notion-as-code in Claude Code?

Run npx skills add makenotion/notion-cookbook --skill notion-as-code -a claude-code. The skill file is installed at ~/.claude/skills/notion-as-code/SKILL.md.

What does notion-as-code do?

It provides instructions for Notion as Code work in an App. The agent reads the SDK skill before creating, editing, or troubleshooting the code.

Which file must the agent read before changing Notion as Code?

It must read node_modules/@notionhq/apps/skills/notion-as-code/SKILL.md relative to the App project root. If the file is missing, install project dependencies; if it remains missing, update @notionhq/apps to a release that includes the skill.

Source text

SKILL.md · MIT

---
name: notion-as-code
description: Declare Notion pages, databases, teamspaces, and custom agents in an App, including data sources used by syncs.
user-invocable: false
---

# Apps Notion as Code

Before creating, modifying, or troubleshooting Notion as Code code, read
`node_modules/@notionhq/apps/skills/notion-as-code/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 Notion as Code changes until you can read the SDK skill.

Similar skills

All skills for Data and databases →

xlsx official anthropics Creates, reads, edits, and converts spreadsheet files. Use it when the requested deliverable is an Excel workbook or another tabular file. 187,223installs google-agents-cli-observability official Google This skill guides you through tracing and monitoring AI agents, including ADK agents. Use it when you need to inspect agent execution or monitor a deployed agent. CX Codex +1 511,300installs caveman-evidence-review JuliusBrussee A read-only skill reviews Caveman Cloud evidence on LLM spend, traces, and routing. Use it to see where a project’s model budget goes. CX Codex +1 104,500installs migration JuliusBrussee Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. CX Codex +1 103,900installs performance-optimization addyosmani An agent skill that measures before it changes code: Core Web Vitals budgets, N+1 queries, missing indexes and slow endpoints. CX Codex +1 65,200installs supabase official supabase Guides the agent through database configuration and strict RLS policies in Supabase. CX Codex GP ChatGPT 8installs

From the same set20