notion-as-code — скилл для Claude Code: что делает и как установить
Скилл задаёт порядок работы с Notion as Code в App: перед изменениями агент читает инструкции SDK. Пригодится для создания и отладки такого кода.
npx skills add makenotion/notion-cookbook --skill notion-as-code -a claude-codeЧто делает notion-as-code
Скилл помогает работать с кодом Notion as Code в App. По описанию проекта, с его помощью объявляют страницы и базы данных Notion, teamspace и пользовательских агентов, а также источники данных для синхронизации.
Перед созданием, изменением или отладкой кода агент должен прочитать node_modules/@notionhq/apps/skills/notion-as-code/SKILL.md относительно корня App. Если файла нет, сначала нужно установить зависимости проекта; если файл всё ещё не появился — обновить @notionhq/apps до выпуска, в который входит скилл SDK. Пока инструкции не прочитаны, продолжать изменения нельзя. Значит, без установленного SDK работа остановится на этом шаге.
Какие задачи решает
- Объявить страницы Notion в App
- Описать базы данных и teamspace
- Добавить пользовательских агентов
- Указать источники данных для синхронизации
Примеры запросов агенту
- Проверь код Notion as Code в моём App и следуй инструкциям SDK.
- Добавь в App декларацию базы данных Notion по правилам скилла.
- Найди проблему в коде Notion as Code и исправь её по инструкциям SDK.
Как установить notion-as-code
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill notion-as-code -a claude-code2Вручную: положить файлы
~/.claude/skills/notion-as-code/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/notion-as-code/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill notion-as-code -a codex2Вручную: положить файлы
.agents/skills/notion-as-code/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill notion-as-code -a cursor2Вручную: положить файлы
.cursor/skills/notion-as-code/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install makenotion/notion-cookbook notion-as-code2Вручную: положить файлы
.github/skills/notion-as-code/SKILL.md1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill notion-as-code -a gemini-cli2Командой платформы
gemini skills install https://github.com/makenotion/notion-cookbook --path apps/agents/skills/notion-as-codeВручную: положить файлы
.devin/skills/notion-as-code/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill notion-as-code -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о notion-as-code
Как установить notion-as-code в Claude Code?
Выполните npx skills add makenotion/notion-cookbook --skill notion-as-code -a claude-code. Файл скилла появится по пути ~/.claude/skills/notion-as-code/SKILL.md.
Что делает notion-as-code?
Он задаёт инструкции для работы с Notion as Code в App: агент читает скилл SDK перед созданием, изменением или отладкой кода.
Что нужно прочитать перед изменением кода Notion as Code?
Файл node_modules/@notionhq/apps/skills/notion-as-code/SKILL.md, расположенный относительно корня App. Если его нет, нужно установить зависимости проекта, а затем при необходимости обновить @notionhq/apps.
Исходный текст
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.
© makenotion · MIT · makenotion/notion-cookbook