Delivery URLs

Skillist uses a single GitHub-like namespace on the apex domain. The org is the organization slug; repo is the skill identifier (formerly called slug in older API versions).

Browse vs delivery

The public registry index stays at skillist.dev/registry. Individual skills live at skillist.dev/{org}/{repo} — not under /registry/.

URL map

Purpose	URL
Registry browse	https://skillist.dev/registry
Skill page	https://skillist.dev/{org}/{repo}
SKILL.md	https://skillist.dev/{org}/{repo}/SKILL.md
Discovery meta	https://skillist.dev/{org}/{repo}/meta
Full bundle	https://skillist.dev/{org}/{repo}/bundle
Script list	https://skillist.dev/{org}/{repo}/scripts
Run script	POST https://skillist.dev/{org}/{repo}/run
Run history	https://skillist.dev/{org}/{repo}/runs

Example

For the public skill skillist/web-perf-audit:

https://skillist.dev/skillist/web-perf-audit
https://skillist.dev/skillist/web-perf-audit/SKILL.md
https://skillist.dev/skillist/web-perf-audit/meta

REST equivalents

Registry metadata and mutations still use the API worker under /v1:

GET https://api.skillist.dev/v1/registry
GET https://api.skillist.dev/v1/registry/{org}/{repo}

Raw delivery and hosted execution are also available on api.skillist.dev when called directly, but canonical public URLs use skillist.dev.

CLI and agents

The CLI defaults delivery to https://skillist.dev:

skillist install skillist/web-perf-audit
curl https://skillist.dev/skillist/web-perf-audit/SKILL.md

Override for staging or local dev:

export SKILLIST_DELIVERY_URL=http://localhost:5173
export SKILLIST_API_URL=http://localhost:8787

MCP install help

registry_install_help returns apex delivery URLs:

• skillMdUrl — https://skillist.dev/{org}/{repo}/SKILL.md
• registryUrl — https://skillist.dev/{org}/{repo}

See Tools reference for parameters (org and repo).

How routing works

DNS zone routing cannot place wildcards mid-path (e.g. skillist.dev/*/SKILL.md), so delivery is implemented in two layers:

1. API worker — serves /{org}/{repo}/SKILL.md, /meta, /bundle, and authenticated /scripts, /run, /runs
2. Web worker — intercepts the same paths on skillist.dev and forwards them to the API worker via a service binding; also proxies /v1/* and /api/* for same-origin SPA requests

The registry browse UI and skill detail pages are served as static assets with SPA fallback.

Related

• Registry — search, publish, and evals
• Sandbox execution — hosted script runs
• CLI — install, publish, and pull from delivery URLs