Publish EmDash content safely via the REST API

Draft, read back, publish with the fresh revision and verify the live page on EmDash CMS, avoiding raw Markdown, duplicates and broken images.

Claude CodeHermes AgentCodex CLICursorMIT (modify, redistribute and use commercially)

What it does

A skill for creating and publishing posts and pages on EmDash CMS through its REST API (or MCP tools) reliably.

  • Draft → read back → publish with the fresh _rev → verify the public page over HTTPS
  • Markdown-to-Portable-Text conversion, including tables, links and HTML blocks
  • Image upload and correct featured_image / OG image values
  • Category/tag assignment and menu items
  • Bulk scheduled publishing by writing directly to D1 and R2

The bundled scripts/check_portable_text.py catches leftover Markdown markers, CR characters and unreplaced table placeholders before you send a payload.

How to use

python scripts/check_portable_text.py payload.json

Ask your agent "save this draft to EmDash and publish it after checking"; it follows the procedure from schema inspection to public-page verification.

Requirements

  • An EmDash site with authenticated REST API or MCP access
  • Python 3, and Node.js if you use the official markdownToPortableText

Notes

  • Writes are never retried blindly; after an ambiguous failure the agent looks up the entry by ID or slug first.
  • Back up the production D1 database before using the direct-write method.

How to install

  1. Unzip the downloaded file (it contains a emdash-content-publishing/ folder with SKILL.md).
  2. Copy the whole folder into your agent's skills folder.
    • Claude Code: ~/.claude/skills/ (per project: .claude/skills/)
    • Hermes Agent: ~/.hermes/skills/
  3. Restart the agent and check that the skill appears in its skill list.

Full guide