zoltanmaric/coppersushi / .agents/skills/ghost-posts
ghost-posts
VerifiedPreviews and updates Ghost post content through the Admin API, including text, links, images, and iframe destinations. Use for content edits rather than theme or server changes.
Ghost posts
Read .secrets/ghost-admin.json with nonempty url and key fields. Keep it
ignored and mode 0600. Never print credentials. Keep credentials, private
snapshots, draft content and preview URLs out of Git. If credentials are missing or rejected, ask the
user to correct this private file. Use the Admin API
or its JavaScript client.
Prepare
- Fetch the target with
GET /ghost/api/admin/posts/slug/{slug}/?formats=lexical,html. Confirm its identity and status; save the original response privately. - Parse its
lexicalJSON string and edit only the intended nodes. For an iframe in an HTML card (type: "html"), change only the intendedsrcin that card'shtml, preserving its other attributes and surrounding markup. - Match replacements exactly; stop if the target is absent or ambiguous. If it
is already correct, do not save. Preserve editor structure instead of
round-tripping rendered HTML through
source=html.
Images
Upload replacements with POST /ghost/api/admin/images/upload/ using multipart
file and purpose=image. The returned images[0].url is a stored image URL;
an upload does not attach itself to a post or replace an existing image.
Update the intended Lexical image src, HTML-card image attributes, bookmark
thumbnail metadata, or post feature_image (landing-page cards). Reuse uploads
for repeated images and retain originals for recovery. Verify hosted size,
dimensions and animation: Ghost can recompress uploads. If using its saved
original copy instead, verify that URL exists and its bytes match the conversion.
Also check the actual responsive URLs rendered by the theme for slow resize
redirects; see the animated-image workflow.
Preview
- Create a temporary draft with the proposed content using
POST /ghost/api/admin/posts/. Copy the writable fields that affect rendering: title, editor content, feature image/alt/caption, authors, tags, excerpt, template, visibility, post code injection, and publication date where present. Omit the original ID, UUID and slug; setstatus: "draft"and omit email options. Leave the original post untouched, including when it is already a draft. - Use the saved draft's UUID to provide
<site-url>/p/<uuid>/. Open it to check the proposed change. A published post's/p/URL redirects to its live page. - Return paired Before (original published URL) and After (Ghost preview URL) links with a short change summary. For an unpublished original, use its Ghost preview URL as Before. Wait for explicit approval before applying changes.
Apply
- After approval, re-fetch the original and compare it with the saved snapshot. If concurrent edits change the proposal, update the preview and seek approval again; do not overwrite them with an old document.
- Update the original, not the preview copy, with
PUT /ghost/api/admin/posts/{id}/?save_revision=true. Send only changed fields and the checkedupdated_at. For body edits, sendposts: [{lexical: JSON.stringify(editedDocument), updated_at: checked.updated_at}]. Preserve unrelated metadata, status and publication date; omit email options. - On a collision, re-fetch and reconcile before retrying. After an uncertain response, read the post to determine whether the edit already succeeded.
Verify
Re-fetch and confirm the intended change and preserved metadata. Check the public page for published posts, or the original post’s Ghost preview for drafts. Verify the affected image, link or embed in a browser; an HTTP 200 alone does not verify an interactive embed. After a successful update, remove only the temporary preview draft created for this edit and report the result.
See Ghost's post format and update contract.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |