SkillFoxx
Telegram

Notion Skills

Официальные скиллы Notion: notion-cli учит агента командам ntn для API и файлов, notion-apps разворачивает проекты Notion Apps.

  • 184 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл `notion-cli` пишет страницы и комментарии, загружает файлы и деплоит воркеры в вашем рабочем пространстве. Начинайте с токена интеграции, подключенного к одной тестовой странице.
Все причины и проверки

makenotion/skillsАвтор:Notion

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/notion-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл `notion-cli` пишет страницы и комментарии, загружает файлы и деплоит воркеры в вашем рабочем пространстве. Начинайте с токена интеграции, подключенного к одной тестовой странице.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Notion Skills — два скилла от самой компании Notion. Скилл `notion-cli` объясняет агенту, как работать через CLI `ntn`: вызывать публичный API (`ntn api`), читать страницу как Markdown (`ntn pages get`), создавать и обновлять страницы, загружать файлы (`ntn files`) и управлять воркерами (`ntn workers`). Агент сверяется со встроенной справкой CLI, чтобы проверить синтаксис. Скилл `notion-apps` помогает начать проект Notion Apps: проверяет установку `ntn`, создает каркас командой `ntn apps new --install --git <каталог>` и отправляет агента читать `AGENTS.md` сгенерированного проекта. Перед работой скилл просит подтвердить участие в альфе Notion Apps.

Для кого. Разработчикам и аналитикам, у которых данные лежат в Notion и которым нужно, чтобы Claude Code или Codex читал базы, писал страницы и деплоил воркеры.

Подходит, если

  • Агент должен прочитать страницу Notion как Markdown и пересказать ее в чате.
  • Нужно создать страницу или комментарий с форматированием через публичный API.
  • В базу данных Notion загружают файлы из локальной папки.
  • Команда пишет воркер Notion и деплоит его командой `ntn workers deploy`.
  • Участник альфы Notion Apps начинает новый проект с каркаса.

Не подходит, если

  • Агент подключается к Notion как к MCP-серверу: для этого есть отдельный официальный MCP.
  • Нужна разработка Notion Apps без доступа к альфе: код соберется локально, но деплой невозможен.
  • Доступ агента к рабочему пространству нежелателен: токен интеграции открывает страницы и базы, к которым он подключен.

Пример запроса к агенту

Через ntn прочитай страницу плана релиза и добавь под ней комментарий с тремя главными замечаниями.

Ограничения

Скиллы не работают без CLI `ntn`: его ставят скриптом `curl -fsSL https://ntn.dev | bash` на macOS и Linux или через `winget install Notion.ntn` на Windows. Для API нужна авторизация: переменная `NOTION_API_TOKEN` или `ntn login` с входом по ссылке в браузере. Скилл `notion-apps` требует участия в альфе Notion Apps, членство CLI или локальная сборка SDK его не подтверждают. Команда `ntn apps` может быть скрыта и включается через `ntn experiments enable apps`. Описания скиллов англоязычные.

Как отключить. Удалите папки `notion-cli` и `notion-apps` из каталога скиллов агента. Токен `NOTION_API_TOKEN` уберите из окружения, выйдите командой `ntn logout`, а интеграцию отключите в настройках Notion.

Частые вопросы

Как поставить официальные скиллы Notion?

Выполните `npx skills add makenotion/skills` для обоих скиллов или `npx skills add makenotion/skills --skill notion-cli` для одного. Установка идет через CLI skills.

Что такое ntn?

Консольная утилита Notion. Через нее скилл вызывает публичный API, читает и создает страницы, загружает файлы и управляет воркерами. Справка встроена: `ntn api ls` и `ntn <команда> --help`.

Как авторизоваться в ntn?

Задайте переменную `NOTION_API_TOKEN`, и CLI использует ее сам. Без токена выполните `ntn login` и откройте выданную ссылку в браузере.

Нужен ли доступ к альфе для notion-apps?

Да. Скилл сначала просит подтвердить участие в альфе Notion Apps. Без нее код проекта соберется локально, но задеплоить его не получится.

Что делает скилл notion-apps?

Проверяет, что установлен `ntn`, создает проект командой `ntn apps new --install --git <каталог>` и отправляет агента читать `AGENTS.md` созданного проекта.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

CLI хранит скиллы агентов в базе Notion: общий каталог, установка нужных на машину, синхронизация и публикация для команды

CLIРасширенный доступ79

Двадцать два отдельных скилла: Notion, Todoist, Tavily, Context7, генерация картинок, конвертация документов в Markdown

СкиллШирокий доступ302

Notion MCP (awkoy)

Notion MCP Server (awkoy)

Notion MCP на токене: агент ищет страницы, ведет базы, правит блоки и комментарии через три инструмента и 47 операций, без ручного входа

MCP-серверШирокий доступ180

Notion Plugin для Claude Code

Notion Plugin for Claude Code

Официальный

Официальный плагин Notion для Claude Code: четыре скилла, десять команд и подключенный MCP-сервер за одну установку

ПлагинШирокий доступ504

MCP-сервер для Notion: агент ищет, читает, запрашивает и обновляет страницы и базы рабочего пространства

MCP-серверШирокий доступ925

Коллекция скиллов для решений и проектов: стратегия, исследование рынка, критическое мышление, анализ данных, документы и слайды.

ПлагинМинимальный доступ109

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Notion Skills (эта карточка)нет184
Notion MCP ServerдаAPI-ключ4 706дает агенту доступ к Notion через MCP-сервер; здесь агент работает с консолью ntn по инструкциям скилла
Notion Plugin для Claude Codeда504плагин Claude Code для Notion; здесь скиллы для любых агентов, поддерживающих формат skills, и проекты Notion Apps

Коротко о README

README короткий: рекомендованный способ установки через CLI skills и таблица из двух скиллов с описаниями. Подробности лежат в самих файлах SKILL.md.

Бейдж для README

Исходный SKILL.md

---
name: notion-cli
description: >-
  Use the Notion CLI (`ntn`) to interact with the Notion API, manage workers,
  and upload files. Use when the user asks to "call the Notion API", "deploy a
  worker", "upload a file to Notion", "create a page", "query a database", or
  any task involving the `ntn` command.
---

# Notion CLI

## Look things up before answering

The CLI is self-documenting. Always prefer running these commands over guessing
syntax or relying on memorized knowledge:

- `ntn api ls` — list every public API endpoint.
- `ntn api <path> --help` — show methods, doc links, and usage for an endpoint.
- `ntn api <path> --docs` — print the full official docs for an endpoint.
- `ntn api <path> --spec` — print a reduced OpenAPI fragment (useful for
  understanding request/response schemas).
- `ntn pages get <page-id>` — retrieve a page as Markdown. Use this to read page
  content.
- `ntn <command> --help` — help for any command or subcommand.

## Install

```bash
curl -fsSL https://ntn.dev | bash
```

## Authentication

- The CLI automatically uses `NOTION_API_TOKEN` when it is set.
- Check `NOTION_API_TOKEN` first. If it is already set, prefer using it instead
  of telling the user to run `ntn login`.
- `ntn login` / `ntn logout` — log the CLI in or out (only use if not using
  `NOTION_API_TOKEN`). `ntn login` requires the user to visit a URL in a web
  browser.

## `ntn api`

Run `ntn api --help` for full syntax. Quick summary:

```bash

Сообщить о проблеме