notion-skills CLI
CLI хранит скиллы агентов в базе Notion: общий каталог, установка нужных на машину, синхронизация и публикация для команды
- 79 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает и пишет страницы вашей базы Notion через `ntn` с правами вашей авторизации
- Установка складывает файлы скиллов, которые агенты затем исполняют как инструкции, в общие каталоги
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/brianlovin-notion-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает и пишет страницы вашей базы Notion через `ntn` с правами вашей авторизации
- Установка складывает файлы скиллов, которые агенты затем исполняют как инструкции, в общие каталоги
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
notion-skills — консольная утилита, которая превращает базу данных Notion в хранилище скиллов для кодовых агентов. Скиллы правят в обычном редакторе Notion, без IDE, git и ревью PR, а на машину устанавливают только нужные. Один каталог читают Claude, Codex, OpenCode, Cursor и Gemini: скиллы ложатся симлинками из центральной папки, плюс запасной путь `~/.agents/skills/`. Команды `list`, `install`, `uninstall`, `sync` и `publish` управляют хранилищем, `gen` просит вашего агента составить черновик по ссылке, файлу или описанию, `add owner/repo` подтягивает публичный скилл из GitHub, `feed` показывает новинки и обновления за неделю, а `audit` проверяет описание и тело скилла. Можно держать несколько источников и обсуждать скиллы в комментариях Notion.
Для кого. Командам, которые делят скиллы между разработчиками и хотят вести их в Notion, и одиночкам с несколькими компьютерами и агентами.
Подходит, если
- Команда пишет скиллы вместе в Notion, а каждый ставит себе только нужные
- Вы переходите между компьютерами и хотите получить свои скиллы командой `notion-skills sync`
- Хочется набросать скилл по ссылке или описанию через `gen` и доработать его в редакторе
- Нужно подтянуть публичный скилл из GitHub в черновики, не подключая его сразу
- Перед публикацией надо проверить описание скилла и маркеры тестов через `audit`
Не подходит, если
- У вас Windows: инструмент рассчитан на macOS и Linux
- Нет рабочего пространства Notion или доступа к его CLI `ntn`
- Скиллы лучше хранить в git с ревью: подход рассчитан на правку в Notion
- Нужна одна общая папка для всех без выбора: инструмент ставит отобранные скиллы
Пример запроса к агенту
Настрой notion-skills для нашей базы Notion, покажи список скиллов и установи те, что с тегом featuredОграничения
Нужны macOS или Linux, Node.js 18 и новее и CLI `ntn`, который ставят через `brew install ntn` и в котором входят командой `ntn login`. Утилита вызывает `ntn` для обращения к Notion, поэтому доступ определяется вашей авторизацией Notion. Черновик остается на вашей машине, пока вы не выполните `publish`. Если из разных источников ставятся скиллы с одним именем, второй получает префикс, например `personal-deploy`, имя меняет флаг `--as`. Для сброса состояния README предлагает `rm -rf ~/.notion-skills` и повторный `notion-skills init`, содержимое Notion при этом не затрагивается.
Как отключить. Выполните `notion-skills uninstall <slug>` для каждого скилла и удалите пакет командой `npm uninstall -g @brianlovin/notion-skills`. Страницы в Notion остаются, их архивирует `unpublish`.
Частые вопросы
Как поставить notion-skills?
Выполните `brew install ntn` и `ntn login`, затем `npm install -g @brianlovin/notion-skills` и `notion-skills init`. Мастер предложит выбрать базу Notion и агентов.
Какие агенты поддерживаются?
Claude, Codex, OpenCode, Cursor и Gemini, плюс общий каталог `~/.agents/skills/`. Скиллы ставятся симлинками из одной папки, поэтому все агенты видят один набор.
Что такое черновик?
Скилл, который еще не готов для команды: он лежит на вашей машине без строки в Notion либо в Notion с выключенным флагом Published. Команда `publish` делает его готовым.
Как установить сразу несколько скиллов?
Командой `notion-skills install --tag featured` ставятся все скиллы с тегом, а флаг `--all` берет весь источник. Теги привязаны к одному источнику.
Что делает команда `doctor`?
Диагностирует проблемы по всем источникам, а флаг `--fix` чинит безопасные. Первый шаг при истекшей авторизации: `ntn logout` и `ntn login`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОфициальные скиллы Notion: notion-cli учит агента командам ntn для API и файлов, notion-apps разворачивает проекты Notion Apps.
Двадцать два отдельных скилла: Notion, Todoist, Tavily, Context7, генерация картинок, конвертация документов в Markdown
Notion Plugin для Claude Code
Notion Plugin for Claude Code
Официальный плагин Notion для Claude Code: четыре скилла, десять команд и подключенный MCP-сервер за одну установку
Личная коллекция скиллов cafe3310: ведение проекта по спецификации, обзор кода, отчеты, браузер, 3D и видео в одном репозитории
CLI на Go, который держит скиллы, агентов и правила в одном месте и синхронизирует их во все AI-агенты одной командой
Skills Manager хранит скиллы в одной библиотеке и подключает их через симлинки к Claude Code, Cursor, Codex и другим агентам без копирования файлов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| notion-skills (эта карточка) | нет | 79 | |
| Notion Skills | нет | 184 | скиллы самого Notion; здесь CLI, который хранит ваши скиллы в базе Notion и ставит их в каталоги агентов |
| Universal Skills Manager | нет | 115 | общий менеджер скиллов; здесь источником служит база Notion с совместной правкой |
Коротко о README
README объясняет, зачем хранить скиллы в Notion, и показывает начало работы и таблицу команд. Дальше идут черновики, несколько источников, состав скилла, поддерживаемые агенты и порядок поиска неисправностей.
Бейдж для README
Исходный SKILL.md
--- name: notion-skills-usage description: > Use the notion-skills CLI to manage AI agent skills from one or more Notion-backed workspace stores. Invoke when the user wants to install a skill from their team's store, publish a local skill they authored, sync installed skills, generate a new skill via their coding agent, manage Notion sources (one database per source), or inspect the state of installed/available/outdated/draft skills. Triggers on commands like install, publish, sync, gen, list, uninstall, unpublish, doctor, init, upgrade, open, import, source. type: core library: notion-skills library_version: "0.17.1" sources: - README.md - CLAUDE.md - .claude/rules/state.md - .claude/rules/drift.md - .claude/rules/gotchas.md --- # Using notion-skills `notion-skills` is an app-store-style CLI for AI coding agent skills. Each Notion database the user has linked is a "source"; they `install` what they want from any source, `publish` to a chosen source, `sync` keeps installed skills fresh across all sources. ## Mental model A skill is in one of three states: - **Installed** — has a manifest entry. Invokable via the agent CLI's `/<slug>` shortcut. - **Draft** — not yet ready for team consumption. Two flavors: (1) local-only (central-store dir exists, no manifest entry, no Notion row), or (2) Notion-side (page exists with `Published = false`). Both share the `✎` marker in `list`. - **Available** — Notion row with `Published = true`, not installed on this machine. Two further sub-states for installed skills: - **Outdated** — the Notion page has changed since the user last synced. - **Local-edited** — the user edited any file in the skill dir (SKILL.md or sibling) without publishing. The verb mapping: | User intent | Verb | |---|---| | Author a new skill via the user's coding agent | `gen <input>` | | Pull a public skill from GitHub | `add <owner/repo>` (mirrors `npx skills add` syntax) |