sync · makenotion — скилл для Claude Code: синхронизация баз Notion
Помогает писать, отлаживать и проверять синхронизацию баз данных Notion App: стабильные ключи и пагинация с продолжением.
npx skills add makenotion/notion-cookbook --skill sync -a claude-codeЧто делает sync
Скилл включается, когда вы создаёте, меняете или чините код синхронизации с базами Notion App. Сам он ничего не делает — он велит агенту сначала прочитать node_modules/@notionhq/apps/skills/sync/SKILL.md относительно корня проекта и дальше следовать инструкциям из этого файла.
Путь разрешается от корня App-проекта. Если файла нет, скилл советует поставить зависимости проекта. Если он всё равно не появился, нужно обновить @notionhq/apps до релиза, в котором скилл уже есть. Пока SDK-скилл не прочитан, менять код синхронизации не стоит: без него агент работает вслепую.
Скилл не вызывается вручную — в описании стоит user-invocable: false. Агент подхватывает его сам, когда задача касается синхронизации баз. Это значит, что в промпте достаточно описать задачу, а не звать команду.
Какие задачи решает
- написать синхронизацию базы Notion App с нуля
- починить сломанную пагинацию при выгрузке записей
- разобраться, почему ключи записей меняются между запусками
- отревьюить чужой код синхронизации перед мержем
- подтянуть версию
@notionhq/apps, в которой есть SDK-скилл
Примеры запросов агенту
- Напиши синхронизацию базы Notion App: стабильные ключи и пагинация с продолжением.
- Разберись, почему при повторной выгрузке записи дублируются.
- Проверь код синхронизации в
src/sync.tsперед мержем.
Как установить sync
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill sync -a claude-code2Вручную: положить файлы
~/.claude/skills/sync/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sync/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill sync -a codex2Вручную: положить файлы
.agents/skills/sync/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill sync -a cursor2Вручную: положить файлы
.cursor/skills/sync/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install makenotion/notion-cookbook sync2Вручную: положить файлы
.github/skills/sync/SKILL.md1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill sync -a gemini-cli2Командой платформы
gemini skills install https://github.com/makenotion/notion-cookbook --path apps/agents/skills/syncВручную: положить файлы
.devin/skills/sync/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill sync -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sync
Как установить sync в Claude Code?
Выполните npx skills add makenotion/notion-cookbook --skill sync -a claude-code. Скилл окажется в ~/.claude/skills/sync/SKILL.md.
Что делает скилл sync?
Заставляет агента прочитать SDK-скилл node_modules/@notionhq/apps/skills/sync/SKILL.md перед любой правкой кода синхронизации баз Notion App и дальше следовать инструкциям из него.
Почему скилл не вызывается командой?
У него стоит user-invocable: false, поэтому он срабатывает сам, когда задача касается синхронизации баз. Отдельной слэш-команды для него нет.
Исходный текст
SKILL.md · MIT
--- name: sync description: Build, debug, or review Notion App database syncs with stable keys and resumable pagination. user-invocable: false --- # App database syncs Before creating, modifying, or troubleshooting sync code, read `node_modules/@notionhq/apps/skills/sync/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 sync changes until you can read the SDK skill.
© makenotion · MIT · makenotion/notion-cookbook
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — sync от других авторов.
