tiptap — скилл для Claude Code: редакторы и установка
Скилл помогает собирать React-редакторы на Tiptap: настраивать расширения, SSR, загрузку изображений и совместное редактирование. Пригодится при добавлении редактора в приложение.
MIT 117 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tiptap -a claude-codeЧто делает tiptap
Скилл описывает настройку редактора на Tiptap для React: создание через useEditor(), вывод через EditorContent и подключение расширений для таблиц, изображений, Markdown и подсветки кода. Также разбирает стилизацию текста и совместное редактирование с Y.js.
Для SSR, включая Next.js, в конфигурацию useEditor() нужно добавить immediatelyRender: false; результат вызова может быть null, поэтому перед обращением к редактору нужна проверка. При работе с Y.js отключают undo/redo через undoRedo: false. Create React App несовместим с ESM-структурой Tiptap v3: для такого проекта скилл советует перейти на Vite.
Скилл охватывает и загрузку изображений: вместо хранения base64 он предлагает запретить base64 и заменять изображение URL после загрузки. Для React-интеграции нужен пакет @tiptap/react, а @tiptap/pm указан как обязательная peer-зависимость. Это важно учесть при настройке зависимостей.
Какие задачи решает
- настроить React-редактор на Tiptap для SSR
- подключить расширения StarterKit и ограничить уровни заголовков
- загружать изображения и сохранять их по URL
- добавить Markdown или таблицы в редактор
- настроить совместное редактирование через Y.js
Примеры запросов агенту
- Настрой редактор Tiptap в React для Next.js и добавь безопасный для SSR вызов
useEditor(). - Добавь в редактор загрузку изображений: запрети base64 и сохраняй загруженные файлы по URL.
- Подключи совместное редактирование через Y.js и отключи undo/redo в
StarterKit.
Как установить tiptap
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tiptap -a claude-code2Вручную: положить файлы
~/.claude/skills/tiptap/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tiptap/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tiptap -a codex2Вручную: положить файлы
.agents/skills/tiptap/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tiptap -a cursor2Вручную: положить файлы
.cursor/skills/tiptap/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tiptap2Вручную: положить файлы
.github/skills/tiptap/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tiptap -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tiptapВручную: положить файлы
.devin/skills/tiptap/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tiptap -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tiptap
Как установить tiptap в Claude Code?
Выполни npx skills add oakoss/agent-skills --skill tiptap -a claude-code. Файл скилла находится по пути ~/.claude/skills/tiptap/SKILL.md.
Что делает tiptap?
Помогает создавать React-редакторы на Tiptap и настраивать их расширения, SSR, стили, загрузку изображений и совместное редактирование.
Что нужно учесть при совместном редактировании через Y.js?
Отключи undo/redo в StarterKit параметром undoRedo: false. В Tiptap v3 для этого используется именно этот ключ.
Исходный текст
SKILL.md · MIT
---
name: tiptap
description: 'Builds rich text editors with Tiptap, a headless ProseMirror-based editor framework for React with Tailwind v4 support. Covers SSR-safe setup, image uploads, prose styling, collaborative editing, and markdown support. Use when adding a rich text editor, configuring Tiptap extensions, handling image uploads in editors, or setting up collaborative editing with Y.js. Use for tiptap, rich text, editor, prosemirror, react, tailwind.'
license: MIT
metadata:
author: oakoss
version: '1.0'
source: 'https://tiptap.dev/docs'
user-invocable: false
---
# Tiptap Rich Text Editor
## Overview
Tiptap is a headless rich text editor built on ProseMirror, providing a modular extension system for React applications. It supports React 19, Tailwind v4, and SSR frameworks like Next.js. Use when building blog editors, comment systems, documentation tools, or Notion-like collaborative apps. Do NOT use with Create React App (CRA is incompatible with Tiptap v3 ESM module structure; use Vite instead).
## Quick Reference
| Pattern | API / Key Point |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Create editor | `useEditor({ extensions: [StarterKit], immediatelyRender: false })` |
| Render editor | `<EditorContent editor={editor} />` |
| Prose styling | Add `className="prose dark:prose-invert max-w-none"` to container |
| Configure StarterKit | `StarterKit.configure({ heading: { levels: [1, 2, 3] } })` |
| Disable undo/redo | `StarterKit.configure({ undoRedo: false })` (required for Y.js collab) |
| Image upload | Set `allowBase64: false`, use upload handler with URL replacement |
| Markdown support | `import { Markdown } from '@tiptap/markdown'` (official, open-source) |
| shadcn component | `npx shadcn@latest add https://raw.githubusercontent.com/Aslam97/shadcn-minimal-tiptap/main/registry/block-registry.json` |
| Null guard | `useEditor()` returns `Editor \| null` — guard before calling methods |
## Core Dependencies
| Package | Purpose |
| ------------------------- | ---------------------------------------------------------- |
| `@tiptap/react` | React integration (React 19 supported since v2.10.0) |
| `@tiptap/starter-kit` | Bundled extensions: marks, nodes, and functionality |
| `@tiptap/pm` | ProseMirror peer dependency (required, not auto-installed) |
| `@tailwindcss/typography` | Prose styling for headings, lists, links |
## StarterKit v3 Contents
| Category | Included |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Marks | Bold, Italic, Strike, Code, Link (v3), Underline (v3) |
| Nodes | Document, Paragraph, Text, Heading, BulletList, OrderedList, ListItem, Blockquote, CodeBlock, HorizontalRule, HardBreak |
| Functionality | Undo/Redo, Dropcursor, Gapcursor, ListKeymap (v3), TrailingNode (v3) |
## Common Additional Extensions
| Extension | Package | Use Case |
| ----------------- | --------------------------------------- | ------------------------------------ |
| Image | `@tiptap/extension-image` | Image support with resize |
| Color | `@tiptap/extension-color` | Text color (requires TextStyle) |
| Typography | `@tiptap/extension-typography` | Smart quotes, dashes, ellipsis |
| Placeholder | `@tiptap/extension-placeholder` | Placeholder text (requires CSS) |
| Table | `@tiptap/extension-table` | Table support (+ Row, Cell, Header) |
| TaskList | `@tiptap/extension-task-list` | Checkbox task lists |
| CodeBlockLowlight | `@tiptap/extension-code-block-lowlight` | Syntax-highlighted code |
| Collaboration | `@tiptap/extension-collaboration` | Real-time multi-user editing (Y.js) |
| Markdown | `@tiptap/markdown` | Bidirectional markdown (open-source) |
## Common Mistakes
| Mistake | Fix |
| ----------------------------------------- | ------------------------------------------------------------------ |
| Missing `immediatelyRender: false` | Add to `useEditor()` config — required for SSR/Next.js |
| No `prose` classes on editor container | Add `className="prose prose-sm dark:prose-invert max-w-none"` |
| Images stored as base64 | Set `allowBase64: false`, use upload handler with URL replacement |
| Using EditorProvider + useEditor together | Choose one — EditorProvider wraps useEditor internally |
| Undo/Redo enabled with Collaboration | Set `undoRedo: false` in StarterKit when using Y.js |
| ProseMirror version conflicts | Add `resolutions` for prosemirror-model/view/state in package.json |
| Using Create React App | Switch to Vite — CRA incompatible with v3 ESM modules |
| Not checking `editor` for null | `useEditor()` returns `Editor \| null` — guard before use |
| Using `history: false` for collab | Config key renamed to `undoRedo` in v3 |
| Importing `@tiptap/extension-markdown` | Correct package is `@tiptap/markdown` |
## Delegation
- **Tailwind styling**: see `tailwind` skill
- **Form integration**: see `tanstack-form` skill
## References
- [Setup and Configuration](references/setup.md)
- [Extensions Catalog](references/extensions.md)
- [Image Upload](references/image-upload.md)
- [Patterns](references/patterns.md)
- [Known Issues and Errors](references/known-issues.md)
- [Prose Styling](references/prose-styling.md)
© oakoss · MIT · oakoss/agent-skills