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