ghost-publishlisted
Install: claude install-skill sitetiller/ai-visibility-skills
# Ghost publishing
Goal: add new pages to a Ghost site with every SEO field set, without any way to change the owner's existing posts.
## Setup (the user does this)
1. Ghost Admin > Settings > Integrations > Add custom integration. Copy the Admin API key (`<id>:<secret>`) and the API URL.
2. Put the key in an environment variable on their machine: `GHOST_ADMIN_API_KEY`. Never paste it into chat.
3. Use the admin URL over https (Ghost(Pro): `https://<name>.ghost.io`).
## Steps
1. Write the page as HTML (`page.html`), with a head snippet if needed (`head.html`, for JSON-LD from `npx sitetiller schema-gen article ...`).
2. Create a draft:
```bash
npx sitetiller ghost create https://example.ghost.io --title "Title" --html-file page.html \
--meta-title "Title tag" --meta-description "150 characters..." --slug my-page --head-file head.html --json
```
Add `--type pages` for a page instead of a post. Output: `id`, `url`, `status` (draft), `owned: true`. The post carries the internal tag `#sitetiller` and is recorded in `.sitetiller/owned.json`.
3. Review in Ghost Admin, then publish:
```bash
npx sitetiller ghost update https://example.ghost.io --id <id> --status published --json
```
Updates read the post first and send its `updated_at`, which Ghost requires to prevent overwriting newer edits.
4. Snapshot the live URL for measurement: `npx sitetiller version snapshot <url> --label "v1"`.
5. To roll back: `npx sitetiller ghost unpublish https://example.g