AutoGineer
Generated banner for Notion Apps
Generated logo for Notion Apps

Notion Apps

NotionOfficialPublished by Notion

  • Skill
  • Workflow
  • Software development
  • MIT
  • Medium risk
Download ZIP

From the author

Set up and scaffold Notion Apps with the Notion Apps SDK and `ntn`; use when starting a Notion App project.
— the description by Notion

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to initializing and scaffolding new Notion App projects. It guides the user through verifying alpha access, installing the necessary Notion CLI tools, and executing the project creation command. It emphasizes the importance of following project-specific guidance found in the generated AGENTS.md file to ensure proper development and deployment workflows.

What it does

  • Verifies user alpha access status for Notion Apps.
  • Installs the Notion CLI on macOS, Linux, or Windows.
  • Scaffolds new App projects with dependencies and Git initialization.
  • Enables necessary CLI experiments for project creation.
  • Directs users to consult AGENTS.md for project-specific implementation details.

When to use it

  • When starting a new Notion App project from scratch.
  • When setting up a development environment for Notion Apps.
  • When you need to ensure the Notion CLI is correctly installed and configured.

Advantages

  • Ensures consistent project structure and dependency management.
  • Automates the installation and initialization process.
  • Provides clear guidance on prerequisites like alpha access.
  • Integrates project-specific documentation into the workflow.

Usage examples

“Help me start a new Notion App project in the current directory.”
The agent verifies alpha access, checks for the Notion CLI, and runs the scaffolding command to initialize the project files and dependencies.
“I want to build a new Notion App, how do I set it up?”
The agent confirms your alpha access, installs the required CLI if missing, and scaffolds the project in your specified directory.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/makenotion/notion-apps/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip notion-apps.zip -d .agents/skills

Documentation by Notion

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:

# 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:

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.

Files

ATTRIBUTION.md

Attribution

This folder is an unmodified copy of the Agent Skill "notion-apps", distributed by AutoGineer (https://autogineer.com/agent-skills).

The skill's own files are unmodified copies. AutoGineer is not affiliated with or endorsed by the author or the publisher.

Files added by AutoGineer

  • ATTRIBUTION.md: this file, written by AutoGineer

  • LICENSE: copied from LICENSE.md

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs network access

Security

What our scanner noticed· Medium risk

  • Instructions that use the network
  • Downloads piped into a shell

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Notion
Publisher
Notion (Official)
Source
makenotion/skills · skills/notion-apps · commit 10e976a
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE.md)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Notion or Notion.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download notion-apps.zip