How do I install the Ghost skill?

Run npx skillmds@latest add acedatacloud/ghost 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 Ghost safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ghost?

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 Ghost free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

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

Ghost by acedatacloud — Agent Skill

Name: Ghost
Rating: 4.2 (5 reviews)
Author: acedatacloud

File contents

Ghost Admin API

Use the bundled standard-library client. The connector injects:

$GHOST_SITE_URL — site root, such as https://blog.example.com
$GHOST_ADMIN_API_KEY — Ghost custom integration key (id:hexsecret)

The key grants administrative publishing access. Never print, log, or place it in command arguments.

G="$SKILL_DIR/scripts/ghost.py"
[ -f "$G" ] || G=$(find /tmp -maxdepth 8 -path '*/skills/*/ghost/scripts/ghost.py' 2>/dev/null | head -1)
[ -f "$G" ] || { echo "ghost script not found" >&2; exit 1; }

python3 "$G" posts --limit 10

Create a private draft

python3 "$G" create --title "Title" --html-file article.html --status draft --confirm

Ghost's Admin API accepts HTML through ?source=html. Convert Markdown to HTML first. create is a dry run unless the trailing argument is --confirm.

Publish

python3 "$G" create --title "Title" --html-file article.html --status published
python3 "$G" create --title "Title" --html-file article.html --status published --confirm

The first command only prints the proposed operation. Before the confirmed call, show the final title and body and obtain explicit approval. Use the returned .posts[0].url; never construct or guess a URL.

Update an existing post

Ghost requires the current updated_at value for conflict detection:

python3 "$G" update --id POST_ID --updated-at "2026-07-21T12:00:00.000Z" \
  --title "Revised title" --html-file revised.html
python3 "$G" update --id POST_ID --updated-at "2026-07-21T12:00:00.000Z" \
  --title "Revised title" --html-file revised.html --confirm

Errors

HTTP	Meaning	Action
401	Invalid/revoked Admin API key	Reconnect Ghost with a current custom-integration key
403	Integration lacks access	Check the integration and site permissions
409	Stale `updated_at`	Re-read the post, review changes, and retry with its latest timestamp
422	Invalid post payload	Surface Ghost's validation message and fix the content

If a confirmed create/update ends with a network error, the result is unknown: do not repeat the write. Run posts, compare title/status/updated time, and only retry after proving Ghost did not accept the original request.

After a confirmed publish returns a real URL, record it once with publish_artifact(kind="article", channel="ghost", ...).

---name: ghostdescription: Create drafts and publish or update posts on a self-hosted Ghost site through the official Admin API. Use when the user mentions Ghost, a Ghost publication, newsletters, or publishing an article to their own Ghost site.license: Apache-2.0--- # Ghost Admin API Use the bundled standard-library client. The connector injects: - `$GHOST_SITE_URL` — site root, such as `https://blog.example.com` - `$GHOST_ADMIN_API_KEY` — Ghost custom integration key (`id:hexsecret`) The key grants administrative publishing access. Never print, log, or place it in command arguments. ```bash G="$SKILL_DIR/scripts/ghost.py" [ -f "$G" ] || G=$(find /tmp -maxdepth 8 -path '*/skills/*/ghost/scripts/ghost.py' 2>/dev/null | head -1) [ -f "$G" ] || { echo "ghost script not found" >&2; exit 1; } python3 "$G" posts --limit 10 ``` ## Create a private draft ```bash python3 "$G" create --title "Title" --html-file article.html --status draft --confirm ``` Ghost's Admin API accepts HTML through `?source=html`. Convert Markdown to HTML first. `create` is a dry run unless the trailing argument is `--confirm`. ## Publish ```bash python3 "$G" create --title "Title" --html-file article.html --status published python3 "$G" create --title "Title" --html-file article.html --status published --confirm ``` The first command only prints the proposed operation. Before the confirmed call, show the final title and body and obtain explicit approval. Use the returned `.posts[0].url`; never construct or guess a URL. ## Update an existing post Ghost requires the current `updated_at` value for conflict detection: ```bash python3 "$G" update --id POST_ID --updated-at "2026-07-21T12:00:00.000Z" \ --title "Revised title" --html-file revised.html python3 "$G" update --id POST_ID --updated-at "2026-07-21T12:00:00.000Z" \ --title "Revised title" --html-file revised.html --confirm ``` ## Errors | HTTP | Meaning | Action | |---|---|---| | 401 | Invalid/revoked Admin API key | Reconnect Ghost with a current custom-integration key | | 403 | Integration lacks access | Check the integration and site permissions | | 409 | Stale `updated_at` | Re-read the post, review changes, and retry with its latest timestamp | | 422 | Invalid post payload | Surface Ghost's validation message and fix the content | If a confirmed create/update ends with a network error, the result is unknown: do not repeat the write. Run `posts`, compare title/status/updated time, and only retry after proving Ghost did not accept the original request. After a confirmed publish returns a real URL, record it once with `publish_artifact(kind="article", channel="ghost", ...)`.

Frequently asked questions

Ghost