# notion-apps

Scaffolds a new Notion App project with the Notion Apps SDK and the ntn CLI, after confirming alpha access.

Skill by Notion. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add makenotion/skills --skill notion-apps
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add makenotion/skills --skill notion-apps -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Fail
- Socket: Pass
- Snyk: Pass

Installs: 174. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/makenotion/skills/notion-apps)

## Source

[Open the source](https://github.com/makenotion/skills/tree/HEAD/skills/notion-apps). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: notion-apps
description: Set up and scaffold Notion Apps with the Notion Apps SDK and `ntn`; use when starting a Notion App project.
---

# Notion Apps

## Confirm alpha access

Before running commands or inspecting an App project, ask the user to confirm that
they are in the Notion Apps alpha. CLI authentication, an enabled CLI experiment, or
a locally working SDK does not confirm alpha access. If the user says no or cannot
confirm, explain that SDK code may build locally but deployment requires alpha access,
and stop the App workflow.

## Set up and scaffold

After alpha access is confirmed, check that the Notion CLI is installed with
`ntn --version`. If it is missing, install it using the command for the user's
platform:

```bash
# macOS and Linux
curl -fsSL https://ntn.dev | bash

# Windows
winget install Notion.ntn
```

Scaffold a fresh App project with dependencies installed and Git initialized:

```bash
ntn apps new --install --git <app-directory>
```

Always pass an explicit destination. Agents cannot use the CLI's interactive
directory prompt. Use `.` when the current directory is empty and is an appropriate
project root; otherwise infer a suitable directory from the user's request or
surrounding context. If no safe destination can be inferred, ask where the project
should go before scaffolding. If the `apps` command is unavailable, enable it with
`ntn experiments enable apps` and retry.

Once the project is instantiated, work from its root and read its `AGENTS.md`
completely. That file contains the App design, implementation, capability, and
deployment guidance for the generated project. Follow it and the installed SDK's
version-specific guidance for the rest of the task.
````

- Previous: [notion-cli](https://syn4pse.dev/terminal/notion-cli.md)
- Next: [redis-core](https://syn4pse.dev/terminal/redis-core.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
