Portable Text Conversion

by sanity-io

Portable Text Conversion is an AI Engineering skill for Claude Code, published by sanity-io in agent-toolkit.

181 stars28 forkson sanity-io/agent-toolkitAdded 2026/09/07+1% in starsRepository updated 2026/09/04

View source on GitHub Download repo ZIP

agent-rulesai-rulesclaude-codeclaude-code-plugincursor-aimcpmcp-servervs-code

Install in seconds

Install Portable Text Conversion

Copy Portable Text Conversion into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/sanity-io/agent-toolkit/tree/main/skills/portable-text-conversion ~/.claude/skills/portable-text-conversion

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/sanity-io/agent-toolkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/portable-text-conversion/SKILL.md in sanity-io/agent-toolkit
Installs to: ~/.claude/skills/portable-text-conversion
Collection: One of 7 skills cataloged from this repository
Category: AI Engineering — 3475 skills

What Portable Text Conversion does

Portable Text Conversion turns HTML and Markdown into Sanity Portable Text blocks. Use it when migrating content, importing rich text, or building pipelines that create Portable Text programmatically.

Portable Text Conversion is cataloged under AI Engineering on DirSkills. Portable Text Conversion comes from a repository tagged agent-rules, ai-rules, claude-code, claude-code-plugin and cursor-ai.

Documentation

README

Excerpt

Portable Text Conversion

Convert external content (HTML, Markdown) into Portable Text for Sanity. Three main approaches:

markdownToPortableText — Convert Markdown directly using @portabletext/markdown (recommended for Markdown)
htmlToBlocks — Parse HTML into PT blocks using @portabletext/block-tools (for HTML migration)
Manual construction — Build PT blocks directly from any source (APIs, databases, etc.)

Portable Text Specification

Understand the target format before converting. PT is an array of blocks:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Portable Text Conversion

What else does sanity-io publish alongside Portable Text Conversion?
Portable Text Conversion is one of 7 skills that DirSkills catalogs from sanity-io/agent-toolkit, the repository it ships in. Its siblings there include Content Experimentation Best Practices, Content Modeling Best Practices and Portable Text Serialization. Each one is a separate skill with its own page in this directory, installs the same way Portable Text Conversion does, and is maintained by sanity-io in that same repository. The rest of the collection is listed on the sanity-io/agent-toolkit page.
How does Portable Text Conversion compare to other AI Engineering skills?
Portable Text Conversion ranks #3088 by stars among the 3475 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Portable Text Conversion against them. Open each page to compare what they document and how they install.