Claude GitHub Copilot Skill

ghost

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.

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download acedatacloud-skills-skills_ghost-c3d1703.zip · 6 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/ghost
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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", ...).

Files (skills)
  • scripts
    • ghost.py 7.4 KB
      Loading…
  • tests
    • test_ghost.py 5.2 KB
      Loading…
  • SKILL.md 2.9 KB
    ---
    name: ghost
    description: 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.
    when_to_use: |
      Trigger when the user wants to list, create, update, draft, or publish posts
      on a self-hosted Ghost site. Public writes require explicit confirmation.
    connections: [ghost]
    allowed_tools: [Bash, publish_artifact]
    license: Apache-2.0
    metadata:
      author: acedatacloud
      version: "1.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", ...)`.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.