How do I install the Publish Path skill?

Run npx skillmds@latest add skillist-io/publish-path in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Publish Path safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Publish Path?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Publish Path free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Publish Path?

skillist-io (@skillist-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Publish Path by skillist-io — Agent Skill

Name: Publish Path
Author: skillist-io

Publish Path

Reference for how a skill version is published and delivered — the KV/R2/DO hot path and realtime broadcast. Use when touching publish, delivery, KV, R2, or realtime code, or when debugging stale/slow reads or missing publish events.

skillist-io 38b41a1 1.9 KB Updated Sep 17, 2026

File contents

Publish & delivery hot path

How Skillist serves published skills at the edge. Keep these invariants when editing.

Storage tiers

KV (SKILLS_KV) — published SKILL.md and meta, for <10ms edge reads. Written by lib/publish.ts, read by lib/delivery.ts / lib/kv.ts. The delivery path must read KV, never Postgres.
R2 (SKILLS_R2) — full bundles (all files). lib/r2.ts handles r2Prefix, sha256, upload/download.
Postgres (via HYPERDRIVE) — source of truth for versions/metadata; used on writes and non-hot reads, not on the delivery hot path.

Publish flow

A publish (publishVersion in lib/ai.ts / route handler) writes the bundle to R2 and the SKILL.md + meta to KV.
It broadcasts a publish event: broadcastPublish(...) → SkillRealtimeHub DO /broadcast.
SkillRealtimeHub (one instance per org:repo, keyed by idFromName) fans the event out to subscribers over WebSocket + SSE.

Delivery flow (public, unauthed)

/{org}/{repo}/SKILL.md and /meta → KV read via deliveryRoutes. /bundle → R2. These are mounted at root in index.ts (app.route("/", deliveryRoutes)) and are intentionally public.

Invariants

Don't add a DB query to the delivery path — it defeats the <10ms budget.
Every publish must write KV and R2 and broadcast; a partial write causes stale delivery or missing realtime updates.
Respect per-user cache scoping and never persist credentials in KV/R2.

Verify

pnpm --filter @skillist/api exec vitest run src/publish-latency.test.ts and related delivery/KV tests, then pnpm check + pnpm typecheck.

Frequently asked questions