xiaolai avatar

Tiptap Editor

This documents the right way to work with Tiptap's editor API when building WYSIWYG interfaces, specifically patterns from the vmark project. It helps you decide when to use Tiptap's high-level commands versus dropping down to ProseMirror directly. Most formatting and content operations should go through editor.commands or the chainable API, while conversion layers and custom selections need direct ProseMirror access. The skill includes real gotchas from production code, like how cursorHandlers.ts incorrectly flattens block structure with textContent instead of using $pos helpers. If you're building on Tiptap and keep second-guessing which API layer to use, this will save you from fighting the framework.

skills.sh installs
296
GitHub stars
911
last updated
Aug 21, 2026

Install

$ npx -y skills add xiaolai/vmark --skill tiptap-editor --agent claude-code

Installs into .claude/skills of the current project.

Files

This documents the right way to work with Tiptap's editor API when building WYSIWYG interfaces, specifically patterns from the vmark project. It helps you decide when to use Tiptap's high-level commands versus dropping down to ProseMirror directly. Most formatting and content operations should go through editor.commands or the chainable API, while conversion layers and custom selections need direct ProseMirror access. The skill includes real gotchas from production code, like how cursorHandlers.ts incorrectly flattens block structure with textContent instead of using $pos helpers. If you're building on Tiptap and keep second-guessing which API layer to use, this will save you from fighting the framework.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/xiaolai/vmark
Categories
Backend & APIs, Code Review & Quality
First seen
Jun 3, 2026

More from xiaolai/vmark

All 2
1omer-metin avatargame-audioomer-metin/skills-for-antigravityExpert game audio designer and implementer specializing in interactive sound design, adaptive music systems, spatial audio, and audio middleware integration. Br295skills.sh installs
2cinience avataralicloud-data-lake-dlf-testcinience/alicloud-skillsMinimal smoke test for DataLake skill. Validate metadata discovery and one read-only API call.294skills.sh installs
3personamanagmentlayer avatartableau-expertpersonamanagmentlayer/pclExpert-level Tableau Desktop/Server, calculated fields, LOD expressions, dashboards, data blending, and performance optimization294skills.sh installs
4dfinity avatarwallet-integrationdfinity/icskillsIntegrate wallets with IC dApps using ICRC signer standards (ICRC-21/25/27/29/49). Covers the popup-based signer model, consent messages, permission lifecycle, 293skills.sh installs
5mhattingpete avatarcode-executionmhattingpete/claude-skills-marketplaceExecute Python code locally with marketplace API access for 90%+ token savings on bulk operations. Activates when user requests bulk operations (10+ files), com293skills.sh installs
6patricio0312rev avatarsql-query-optimizerpatricio0312rev/skillsAnalyzes and optimizes SQL queries using EXPLAIN plans, index recommendations, query rewrites, and performance benchmarking. Use for "query optimization", "slow293skills.sh installs