skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
xiaolai/vmark80 installs

tiptap-dev

Tiptap and ProseMirror work in VMark's WYSIWYG editor - custom nodes, marks and extensions, input and paste rules, the commands API, node views, selection handling and node traversal, and when to drop to raw ProseMirror. Use when changing editor commands, plugins or extensions.

How do I install this agent skill?

npx skills add https://github.com/xiaolai/vmark --skill tiptap-dev
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides legitimate documentation and code examples for developing with the Tiptap rich-text editor framework. No malicious patterns or security risks were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    7/7 files flagged

What does this agent skill do?

Tiptap Development (VMark)

VMark's WYSIWYG editor is Tiptap on ProseMirror. This skill covers both the general Tiptap API and where VMark uses Tiptap versus raw ProseMirror.

Tiptap API or ProseMirror?

Prefer the Tiptap API for: format commands (bold, italic, underline…), block type changes, list operations, table operations through the table extension, content insertion and replacement, and state queries (isActive, getAttributes). Use editor.commands.x() for one operation and editor.chain().focus().x().run() when focus is needed or operations chain.

Use ProseMirror directly for:

  • The markdown conversion layer (src/utils/markdownPipeline/ — mdastToProseMirror.ts and the mdast*Converters.ts family)
  • Multi-cursor selection subclassing (src/plugins/shared/MultiSelection.ts)
  • Custom node views, low-level transactions, schema-level operations

Respect block boundaries. Never flatten with doc.textContent when a position or block matters; resolve the position and use the $pos helpers ($pos.parent, $pos.before(depth), $pos.after(depth)). references/vmark-patterns.md has the $pos reference.

VMark examples to copy from: src/plugins/toolbarActions/wysiwygAdapter*.ts (block, list, code-block and CJK operations), src/plugins/editorPlugins.tiptap.ts (state checks), src/components/Editor/TiptapEditor.tsx (content setup). Plugins must not import app stores (lint:store-coupling; rule 00).

When to Use This Skill

  • Creating custom nodes, marks, or extensions for Tiptap
  • Implementing input rules or paste rules
  • Working with the Tiptap commands API
  • Building React integrations with useEditor
  • Extending existing extensions
  • Creating custom node views
  • Understanding the schema and content model

Reference Files

FileDescription
references/extensions.mdExtension types (Node, Mark, Extension), creation patterns
references/commands-and-api.mdCommands API, editor API, chaining
references/input-paste-rules.mdInput rules and paste rules
references/react-integration.mdReact-specific hooks and components
references/schema.mdSchema properties, content patterns
references/examples.mdComplete working examples
references/vmark-patterns.mdCommands, state queries, $pos traversal and transactions, as VMark uses them

Quick Reference

Extension Types

// Functionality extension (no schema)
Extension.create({ name: 'myExtension', addKeyboardShortcuts() { ... } })

// Node extension (block content)
Node.create({ name: 'myNode', group: 'block', content: 'inline*' })

// Mark extension (inline formatting)
Mark.create({ name: 'myMark', parseHTML() { ... }, renderHTML() { ... } })

Command Chaining

editor.chain().focus().toggleBold().run()
editor.can().chain().focus().toggleBold().run() // dry run

React Integration

const editor = useEditor({
  extensions: [StarterKit],
  content: '<p>Hello</p>',
  immediatelyRender: false, // for SSR
})

Core Concepts

  1. Headless Architecture: Tiptap provides logic, you control rendering
  2. Extension-Based: Everything is an extension (nodes, marks, functionality)
  3. ProseMirror Foundation: Built on ProseMirror, full access to its APIs
  4. Schema-Driven: Content model defined by node/mark schemas
  5. Command Pattern: All operations via chainable commands

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/xiaolai/vmark/tiptap-dev">View tiptap-dev on skillZs</a>