SKILL.md
Using Ghost Admin API
Most Ghost operations use the ghst MCP tools directly. Use this skill to route to the one custom script still needed (publish-lexical.js for markdown → lexical with bookmark cards, GitHub footer, table conversion).
Decision tree
- Post a draft from markdown → [
creatingadraft.md](creatingadraft.md) (usespublish-lexical.js) - Sync Ghost post metadata back to local markdown (CHECK phase) →
npm run sync-ghost <slug> - Backlink curation → use the
backlink_curatingskill - Everything else (read/query/update/stats) → MCP tools below
MCP tools quick reference
| Operation | MCP Tool | Notes |
|---|---|---|
| Search posts | ghost_search |
Full-text across posts, pages, tags |
| List posts | ghostpostlist |
Supports filter, status, limit |
| Get post | ghostpostget |
By slug or id |
| Create / update / delete | ghostpostcreate / ghostpostupdate / ghostpostdelete |
Delete needs confirm: true |
| Publish / schedule | ghostpostpublish / ghostpostschedule |
Schedule takes at datetime |
| Tags | ghosttaglist / create / update / _delete |
|
| Image upload | ghostimageupload |
Local file path |
| Site / settings | ghostsiteinfo / ghostsettinglist / ghostsettingget |
|
| Stats | ghoststatsoverview / post / web / growth / email |
|
| Members, pages, newsletters | ghostmemberlist / ghostpagelist / ghostnewsletterlist |
Reference
- [/docs/ghost-lexical-format.md](../../../docs/ghost-lexical-format.md) — comprehensive lexical format reference. Consult when constructing complex lexical structures for
publish-lexical.js. - [scripts/ghost-lexical-single.js](scripts/ghost-lexical-single.js) — reference documentation only (a LexicalBuilder API illustration). Do NOT require it or write per-post publishing scripts;
scripts/publish-lexical.jsat the repo root is the only canonical publishing path.
Reminders
- Announce that you're using this skill.
- MCP tools handle auth via the ghst CLI; no manual JWT needed.
- Ghost docs are sparse — report any surprises so we can improve these instructions.