К основному содержанию
скилл CX Codex

tiptap — скилл для Claude Code: редакторы и установка

Скилл помогает собирать React-редакторы на Tiptap: настраивать расширения, SSR, загрузку изображений и совместное редактирование. Пригодится при добавлении редактора в приложение.

MIT 117 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill tiptap -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/tiptap/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tiptap/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
liveblocks-best-practices liveblocks Скилл liveblocks-best-practices по Liveblocks: подсказывает агенту, как собирать комнаты, комментарии, курсоры и совместное редактирование, и разбирает типичные ошибки. CX Codex +1 931установок syncfusion-react-blockeditor Syncfusion Inc Скилл помогает агенту подключить Syncfusion React BlockEditor: блочный редактор контента с меню, drag-and-drop и совместной работой. CX Codex +1 736установок nuxt-studio secondsky Настраивает визуальный редактор Nuxt Studio для проектов на Nuxt Content. Помогает подключить авторизацию через OAuth и развернуть редактор на поддомене в Cloudflare. CX Codex +1 388установок yjs-best-practices liveblocks Скилл yjs-best-practices подсказывает агенту, как не сломать синхронизацию Yjs: дубли импортов, поддокументы, YKeyValue и V2-кодирование. CX Codex +1 325установок real-time-collaboration-engine curiositech Скилл real-time-collaboration-engine для Claude Code помогает проектировать совместное редактирование в реальном времени через WebSockets, OT или CRDT. Описывает синхронизацию редакторов, досок и курсоров. CX Codex +1 195установок implementing-realtime-sync ancoleman Скилл implementing-realtime-sync помогает выбрать и настроить транспорт для передачи данных в реальном времени: стриминг токенов LLM, чаты, совместное редактирование через CRDT и офлайн-синхронизацию. CX Codex +1 1установок

Из того же набора106

Весь набор →
quality-auditor Скилл quality-auditor проводит аудит кода по 12 взвешенным измерениям, ставит оценки с опорой на доказательства и собирает план улучшений. CX Codex +1 120установок package-publishing Скилл package-publishing помогает настроить package.json, сборку ESM и CJS и публикацию TypeScript-библиотеки в npm. Пригодится при настройке точек входа и проверок перед релизом. CX Codex +1 119установок svelte Справочник по Svelte 5 и SvelteKit для ИИ-агента: руны, сниппеты, роутинг, form actions и таблица перевода кода с Svelte 4. CX Codex +1 117установок react-native Помогает проектировать мобильные приложения на React Native и Expo с файловой маршрутизацией, EAS Build и нативными API под iOS и Android. CX Codex +1 117установок agent-patterns Скилл agent-patterns для Claude Code описывает паттерны мультиагентных систем и субагентов для организации задач в изолированных контекстах. CX Codex +1 115установок tanstack-cli Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits. CX Codex +1 115установок better-auth Подгружает агенту справочник по better-auth: конфиг, плагины, стратегии сессий и типовые ошибки. Даёт справку при настройке входа, 2FA и организаций. CX Codex +1 114установок meta-skill-creator Скилл meta-skill-creator помогает создавать и проверять агентские скиллы по открытому стандарту Agent Skills. Он пригодится при подготовке SKILL.md, структуры папок и файлов для распространения. CX Codex +1 114установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой