ghost-admin_skill

This skill helps you manage Ghost CMS content via Admin API v5, enabling post creation, publishing, tagging, image uploads, and site information.

Python

2.5k

GitHub Stars

5

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill ghost-admin

_meta.json635 B
config.example.json163 B
config.json163 B
README.md2.7 KB
SKILL.md8.5 KB

Overview

This skill provides a full Ghost CMS Admin API v5 client to create, edit, publish, and manage content programmatically. It uses HS256 JWT auth with only requests as an external dependency and includes CLI and Python module interfaces. Use it for posts, pages, tags, images, members (read), and basic site info while respecting configurable safety controls.

How this skill works

The skill talks to Ghost Admin API v5 using a short-lived HS256 JWT generated per request and the configured admin key. It exposes a GhostClient Python class and a CLI covering posts, pages, tags, image uploads, and read access to members/newsletters/tiers. Behavior is governed by a local config.json and credentials file to enforce publish/delete/member access and readonly limits.

When to use it

Create, update, schedule, publish, unpublish, or delete (if allowed) blog posts and static pages
Manage tags and batch-create or list tags for content organization
Upload feature images and media to embed in posts
Read members, newsletters, and tier information when member access is enabled
Check site/account settings and validate API connectivity

Best practices

Keep credentials in ~/.openclaw/secrets/ghost_creds with strict permissions (chmod 600)
Set allow_publish:false and default_status:"draft" for suggestion-only workflows
Use default_tags in config.json to auto-tag agent-created content consistently
Validate permissions with scripts/init.py after changing integration keys
Generate drafts and return editor preview links for human review before publishing

Example use cases

Draft a research-based article: create draft with SEO metadata, return editor preview URL, publish after approval
Content audit by tag: list all posts for a tag, separate drafts vs published, produce backlog summary
Batch tag creation: ensure taxonomy exists before bulk publishing or tagging new posts
Image-first workflow: upload feature image, embed returned URL in post HTML, then publish
Newsletter integration: read member/newsletter info to tailor posts for subscribers (requires member access)

FAQ

Yes if allow_publish is true in config.json. Set allow_publish:false to force drafts-only behavior (no error raised).

Does it manage themes, webhooks, or email sending?

No. Theme management requires Ghost CLI, webhooks and email sending are outside this skill. Publishing triggers Ghost's built-in newsletter/email behavior automatically.

How are credentials provided and secured?

Store GHOST_URL and GHOST_ADMIN_KEY in ~/.openclaw/secrets/ghost_creds (chmod 600). The client generates short-lived JWTs per request; no long-lived token caching is used.

Can I read members and newsletters?

Yes if allow_member_access is enabled in config.json; otherwise member endpoints are blocked.