[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75E98XC12T92WR99RPDFN2A":3,"skill-same:01M75E98XC12T92WR99RPDFN2A":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":66,"commitSha":67,"skillDirectory":68,"forksCount":69,"repositoryHtmlUrl":70,"repositoryHomepageUrl":6,"ownerHtmlUrl":71,"ownerBlogUrl":72,"ownerDescription":73,"updatedAt":74,"install":75,"resources":87},"01M75E98XC12T92WR99RPDFN2A","ghost-cms-skill",null,"Comprehensive Ghost CMS integration for creating, publishing, scheduling, and managing blog content, newsletters, members, and analytics. Use when working with Ghost blogs for content creation (drafts, publishing, scheduling), member\u002Fsubscriber management (tiers, newsletters), comment moderation, or analytics (popular posts, subscriber growth). Supports all Ghost Admin API operations.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fchrisagiddings\u002Fghost-cms\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: ghost-cms-skill\ndescription: Comprehensive Ghost CMS integration for creating, publishing, scheduling, and managing blog content, newsletters, members, and analytics. Use when working with Ghost blogs for content creation (drafts, publishing, scheduling), member\u002Fsubscriber management (tiers, newsletters), comment moderation, or analytics (popular posts, subscriber growth). Supports all Ghost Admin API operations.\nauthor: Chris Giddings\nhomepage: https:\u002F\u002Fgithub.com\u002Fchrisagiddings\u002Fmoltbot-ghost-skill\nrepository: https:\u002F\u002Fgithub.com\u002Fchrisagiddings\u002Fmoltbot-ghost-skill\nmetadata: {\"openclaw\":{\"disable-model-invocation\":true,\"capabilities\":[\"content-management\",\"member-management\",\"subscription-management\",\"comment-management\",\"user-management\",\"media-management\",\"destructive-operations\",\"public-publishing\"],\"requires\":{\"env\":[\"GHOST_ADMIN_KEY\",\"GHOST_API_URL\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"GHOST_ADMIN_KEY\",\"install\":{\"type\":\"npm\",\"directory\":\"scripts\",\"command\":\"npm install\",\"dependencies\":[\"form-data@^4.0.5\",\"jsonwebtoken@^9.0.3\"]},\"credentials\":{\"types\":[{\"type\":\"file\",\"locations\":[\"~\u002F.config\u002Fghost\u002Fapi_key\",\"~\u002F.config\u002Fghost\u002Fapi_url\"],\"description\":\"Ghost Admin API credentials\"},{\"type\":\"env\",\"variables\":[{\"name\":\"GHOST_ADMIN_KEY\",\"description\":\"Ghost Admin API key (JWT)\",\"required\":true},{\"name\":\"GHOST_API_URL\",\"description\":\"Ghost site URL (Ghost Pro OR self-hosted, include :PORT if needed)\",\"required\":true}]}]}}}\n---\n\n# Ghost CMS\n\nManage Ghost blog content, members, analytics, and newsletters through the Ghost Admin API.\n\n## ⚠️ Security Warning\n\n**Ghost Admin API keys provide FULL access to your Ghost site:**\n\n- **Content Management:** Create, update, delete, publish posts and pages\n- **Member Management:** Add, modify, delete members and subscriptions\n- **Subscription Management:** Create, modify, delete membership tiers\n- **Comment Management:** Reply to, approve, delete comments\n- **User Management:** Invite, modify, delete users\n- **Media Management:** Upload images and files (affects storage)\n- **Site Configuration:** Modify newsletters and settings\n\n**Published content is IMMEDIATELY PUBLIC** - be extra careful with publish operations.\n\n**Security Best Practices:**\n- **Store API keys securely** - Use 1Password CLI or secure env vars\n- **Review before publishing** - Always check content before making it public\n- **Never commit keys** - Keep credentials out of version control\n- **Rotate keys regularly** - Create new integrations every 90 days\n- **Use dedicated integrations** - Separate keys for different use cases\n- **Test on staging first** - Use a test Ghost site when possible\n\n**Admin API Key Scope:**\nGhost Admin API keys have **no scoping options** - they provide full access to everything. There are no read-only keys.\n\n**Operation Types:**\n\n**Read-Only Operations** (✅ Safe):\n- List posts, pages, tags, members, tiers, newsletters, comments\n- Get analytics and member stats\n- All GET requests\n\n**Destructive Operations** (⚠️ Modify or delete data, may be public):\n- Create\u002Fupdate\u002Fdelete posts, pages, tags (POST, PUT, DELETE)\n- Publish\u002Funpublish\u002Fschedule posts (**makes content public**)\n- Create\u002Fupdate\u002Fdelete members, tiers, newsletters\n- Create replies, approve\u002Fdelete comments\n- Upload images (uses storage quota)\n- All POST, PUT, DELETE requests\n\nFor detailed operation documentation, see [api-reference.md](references\u002Fapi-reference.md).\n\n## Quick Setup\n\n1. **Get your Ghost Admin API credentials:**\n   - Ghost dashboard → Settings → Integrations\n   - Create a new \"Custom Integration\"\n   - Copy the **Admin API Key** and **API URL**\n\n2. **Store credentials securely:**\n\n   **Option A: Environment Variables (Recommended)**\n   ```bash\n   # Add to your shell profile (~\u002F.zshrc, ~\u002F.bashrc)\n   export GHOST_ADMIN_KEY=\"YOUR_ADMIN_API_KEY\"\n   export GHOST_API_URL=\"YOUR_GHOST_URL\"\n   ```\n\n   **API URL Examples (works with ALL hosting types):**\n   ```bash\n   # Ghost(Pro) hosted\n   export GHOST_API_URL=\"https:\u002F\u002Fyourblog.ghost.io\"\n   \n   # Self-hosted with reverse proxy (production)\n   export GHOST_API_URL=\"https:\u002F\u002Fblog.yourdomain.com\"\n   \n   # Self-hosted development (Ghost default port 2368)\n   export GHOST_API_URL=\"http:\u002F\u002Flocalhost:2368\"\n   \n   # Self-hosted with custom port\n   export GHOST_API_URL=\"https:\u002F\u002Fghost.example.com:8080\"\n   ```\n\n   **Important:**\n   - Always include protocol (`http:\u002F\u002F` or `https:\u002F\u002F`)\n   - Include `:PORT` if Ghost runs on non-standard port\n   - Do NOT include trailing slash\n   - Do NOT include `\u002Fghost\u002Fapi\u002Fadmin` (added automatically)\n\n   **Option B: Config Files**\n   ```bash\n   mkdir -p ~\u002F.config\u002Fghost\n   echo \"YOUR_ADMIN_API_KEY\" > ~\u002F.config\u002Fghost\u002Fapi_key\n   echo \"YOUR_GHOST_URL\" > ~\u002F.config\u002Fghost\u002Fapi_url\n   \n   # Secure the files (owner read-only)\n   chmod 600 ~\u002F.config\u002Fghost\u002Fapi_key\n   chmod 600 ~\u002F.config\u002Fghost\u002Fapi_url\n   ```\n\n   **Option C: 1Password CLI (Most Secure)**\n   ```bash\n   # Store key in 1Password\n   op item create --category=API_CREDENTIAL \\\n     --title=\"Ghost Admin API\" \\\n     admin_key[password]=\"YOUR_ADMIN_API_KEY\" \\\n     api_url[text]=\"YOUR_GHOST_URL\"\n\n   # Use in commands\n   export GHOST_ADMIN_KEY=$(op read \"op:\u002F\u002FPrivate\u002FGhost Admin API\u002Fadmin_key\")\n   export GHOST_API_URL=$(op read \"op:\u002F\u002FPrivate\u002FGhost Admin API\u002Fapi_url\")\n   ```\n\n   **Security Notes:**\n   - Keys provide **full site access** - protect them like passwords\n   - Rotate keys every 90 days (create new integration, revoke old)\n   - Never commit to git or share keys publicly\n   - Consider separate keys for production vs. staging\n   - **HTTPS recommended:** Use HTTPS for production (HTTP acceptable for localhost only)\n\n3. **Install dependencies:**\n   ```bash\n   cd ghost-cms-skill\u002Fscripts\n   npm install\n   ```\n\n   **Dependencies installed:**\n   - `form-data` (^4.0.5) - Multipart file uploads (theme ZIP files)\n   - `jsonwebtoken` (^9.0.3) - JWT token generation for Ghost Admin API authentication\n\n   **Optional dependencies** (install manually if needed):\n   - `gscan` (^5.2.4) - Official Ghost theme validator (from TryGhost)\n     - Only needed for theme validation feature\n     - Install with: `cd scripts && npm install gscan`\n\n   **All dependencies from public npm registry. No custom downloads.**\n\n4. **Test connection:**\n   See [setup.md](references\u002Fsetup.md) for detailed authentication and troubleshooting.\n\n## Tools & Utilities\n\n### Snippet Extractor\n\n**Purpose:** Migrate existing Ghost snippets to local library for programmatic use.\n\n**Why needed:** Ghost Admin API blocks snippet access (403 Forbidden) for integration tokens. This tool works around that limitation.\n\n**Usage:**\n```bash\n# Extract snippets from a specially-formatted draft post\nnode scripts\u002Fsnippet-extractor.js my-snippets-post\n\n# Validate format before extracting\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --validate\n\n# Preview without saving\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --dry-run\n\n# Custom marker prefix\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --marker \"This is:\"\n\n# Full help\nnode scripts\u002Fsnippet-extractor.js --help\n```\n\n**Workflow:**\n1. Create draft post in Ghost\n2. For each snippet: add paragraph marker (e.g., \"SNIPPET: name\" or \"This is: name\")\n3. Insert the snippet content below each marker\n4. Run extractor → all snippets saved to `snippets\u002Flibrary\u002F`\n\n**Features:**\n- ✅ Extracts all card types (bookmarks, callouts, images, markdown, HTML, etc.)\n- ✅ Preserves exact Lexical structure\n- ✅ Auto-detects credentials from `~\u002F.config\u002Fghost\u002F` or env vars\n- ✅ Supports custom marker formats\n- ✅ Dry-run and validation modes\n- ✅ Verbose output for debugging\n\n**Example:**\n```bash\n# User has 12 snippets in Ghost\n# Creates \"My Snippets\" draft with markers\n# Runs: node scripts\u002Fsnippet-extractor.js my-snippets --marker \"This is:\"\n# Result: All 12 snippets in library\u002F ready for use\n```\n\nSee `snippets\u002FREADME.md` for complete documentation.\n\n### Theme Manager\n\n**Purpose:** Upload, activate, switch, and manage Ghost themes programmatically.\n\n**Why needed:** Automate theme deployments, switch themes, manage theme versions.\n\n**Usage:**\n```bash\ncd scripts\n\n# List all installed themes\nnode theme-manager.js list\n\n# Upload theme ZIP\nnode theme-manager.js upload \u002Fpath\u002Fto\u002Ftheme.zip\n\n# Upload and activate immediately\nnode theme-manager.js upload \u002Fpath\u002Fto\u002Ftheme.zip --activate\n\n# Activate existing theme\nnode theme-manager.js activate theme-name\n\n# Download theme backup\nnode theme-manager.js download theme-name backup.zip\n\n# Delete theme (cannot delete active theme)\nnode theme-manager.js delete old-theme\n\n# Show current active theme\nnode theme-manager.js active\n```\n\n**Features:**\n- ✅ Upload custom themes from ZIP files\n- ✅ Switch between installed themes\n- ✅ Download theme backups\n- ✅ Delete unused themes\n- ✅ Validation and error handling\n- ✅ **Immediate activation** - theme changes are public instantly\n\n**⚠️ Important:**\n- Theme activation is **immediate and public** - site appearance changes instantly\n- Cannot delete the currently active theme (switch first)\n- Themes must be valid Ghost theme ZIP files\n\n**Workflow:**\n```bash\n# Safe theme switching with rollback\nnode theme-manager.js active              # Note current theme\nnode theme-manager.js activate new-theme  # Switch to new theme\n# Test site in browser\nnode theme-manager.js activate old-theme  # Rollback if needed\n```\n\nSee `references\u002Fthemes.md` for complete theme management documentation and best practices.\n\n### Theme Validator\n\n**Purpose:** Validate Ghost themes before uploading using official gscan validator.\n\n**⚠️ Optional Feature:** Requires `gscan` package. Install with:\n```bash\ncd scripts\nnpm install gscan\n```\n\n**Why needed:** Catch errors early - missing files, invalid syntax, deprecated helpers, version incompatibility.\n\n**Usage:**\n```bash\ncd scripts\n\n# Validate theme directory\nnode theme-validator.js ~\u002Fthemes\u002Fmy-theme\u002F\n\n# Validate ZIP file  \nnode theme-validator.js theme.zip\n\n# Target specific Ghost version\nnode theme-validator.js theme.zip --version v6\n\n# JSON output for CI\u002FCD\nnode theme-validator.js theme.zip --json\n\n# Show only errors (hide warnings)\nnode theme-validator.js theme.zip --errors-only\n```\n\n**Features:**\n- ✅ Official Ghost validator (gscan from TryGhost)\n- ✅ Same validation as Ghost Admin\n- ✅ Validates directories or ZIP files\n- ✅ Ghost v5\u002Fv6 compatibility checking\n- ✅ Finds deprecated helpers and syntax errors\n- ✅ CI\u002FCD integration (JSON output, exit codes)\n- ✅ Categorized issues (errors, warnings, recommendations)\n\n**Validation levels:**\n- **Errors** - Must fix before upload (theme will be rejected)\n- **Warnings** - Should fix for best compatibility\n- **Recommendations** - Nice to have (best practices)\n\n**Safe deployment workflow:**\n```bash\n# 1. Validate before upload\nnode theme-validator.js my-theme.zip\n\n# 2. Fix any errors\n\n# 3. Re-validate\nnode theme-validator.js my-theme.zip\n\n# 4. Upload when clean\nnode theme-manager.js upload my-theme.zip\n```\n\n**CI\u002FCD integration:**\n```bash\nnode theme-validator.js theme.zip --json\nif [ $? -eq 0 ]; then\n  node theme-manager.js upload theme.zip --activate\nfi\n```\n\n**Exit codes:** 0 = valid, 1 = errors found, 2 = invalid arguments\n\nSee `references\u002Fthemes.md` for complete validation documentation and common error fixes.\n\n---\n\n## Core Operations\n\nThis skill covers all major Ghost operations. Navigate to the relevant reference for detailed guidance:\n\n### Content Management\n**When to use:** Creating drafts, publishing posts, scheduling content, managing pages\n\nSee **[content.md](references\u002Fcontent.md)** for:\n- Creating new posts (drafts)\n- Publishing and scheduling posts\n- Updating existing content\n- Managing tags, featured images, metadata\n- Working with pages vs posts\n\nSee **[lexical-cards.md](references\u002Flexical-cards.md)** for:\n- **Complete Lexical card type reference** (23 documented types)\n- Most comprehensive Ghost Lexical documentation available\n- Full JSON structures with field references\n- Video, audio, file uploads, buttons, toggles, embeds\n- Product cards, headers, call-to-action, paywall\n- Member visibility and content personalization\n\n**⚠️ Ghost Snippets Limitation:**\n\nGhost's native snippet feature (reusable content blocks saved in the editor) **cannot be accessed via the Admin API** with integration tokens (403 Forbidden). This means:\n\n- ❌ Cannot list available snippets\n- ❌ Cannot fetch snippet content\n- ❌ Cannot programmatically use author's existing snippets\n\n**Solution: Automated Snippet Extraction**\n\nThe skill includes a **snippet extractor tool** that migrates Ghost snippets to local files:\n\n1. **Create extraction post** in Ghost with all snippets (one-time setup)\n2. **Run extractor:** `node scripts\u002Fsnippet-extractor.js post-slug`\n3. **Done!** All snippets saved to `snippets\u002Flibrary\u002F` for programmatic use\n\n**Commands:**\n```bash\n# Extract snippets (auto-detects credentials from ~\u002F.config\u002Fghost\u002F)\nnode scripts\u002Fsnippet-extractor.js my-snippets-post\n\n# Validate format before extracting\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --validate\n\n# Preview without saving\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --dry-run\n\n# Custom marker format\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --marker \"This is:\"\n\n# Full help\nnode scripts\u002Fsnippet-extractor.js --help\n```\n\n**Benefits:**\n- ✅ Migrate all existing Ghost snippets in seconds\n- ✅ Preserves exact Lexical structure (bookmarks, callouts, images, etc.)\n- ✅ Git version control\n- ✅ Use programmatically in automated posts\n- ✅ Works with any card types\n\nSee `snippets\u002FREADME.md` for complete documentation on extraction workflow and local snippet usage.\n\n### Analytics & Insights\n**When to use:** Checking subscriber counts, popular content, traffic trends\n\nSee **[analytics.md](references\u002Fanalytics.md)** for:\n- Subscriber growth and counts\n- Most popular posts (views, engagement)\n- Tag\u002Ftopic performance over time\n- Member tier distribution\n\n### Comments & Engagement\n**When to use:** Responding to comments, moderating discussions\n\nSee **[comments.md](references\u002Fcomments.md)** for:\n- Listing pending\u002Funanswered comments\n- Responding to comments\n- Comment moderation\n\n### Members & Subscribers\n**When to use:** Managing subscriber tiers, member access, premium content\n\nSee **[members.md](references\u002Fmembers.md)** for:\n- Subscriber tier management\n- Member-only content settings\n- Recent subscriber activity\n- Subscription status\n\n### Newsletters\n**When to use:** Managing newsletter settings, email campaigns\n\nSee **[newsletters.md](references\u002Fnewsletters.md)** for:\n- Newsletter configuration\n- Sending newsletters\n- Subscriber email settings\n\n## API Reference\n\nFor advanced operations or endpoint details, see **[api-reference.md](references\u002Fapi-reference.md)**.\n\n## Common Workflows\n\n**Draft → Notion → Ghost:**\n1. Draft content collaboratively in Notion\n2. Finalize content\n3. Use this skill to copy to Ghost as draft\n4. Review in Ghost admin\n5. Schedule or publish\n\n**Weekly content series:**\n1. \"Navi, write and publish a unique weekly post about [topic from our discussions this week]\"\n2. Skill creates post, sets author to \"Navi\", publishes automatically\n\n**Comment management:**\n1. \"Are there any pending comments?\"\n2. Review list of comments with post titles\n3. \"Respond to comment #123 with [response]\"\n\n**Analytics check:**\n1. \"What tags have been most popular in the past 6 months?\"\n2. \"How many new subscribers this month?\"\n3. \"When was my last subscriber-exclusive post?\"\n","# Ghost CMS\n\nManage Ghost blog content, members, analytics, and newsletters through the Ghost Admin API.\n\n## ⚠️ Security Warning\n\n**Ghost Admin API keys provide FULL access to your Ghost site:**\n\n- **Content Management:** Create, update, delete, publish posts and pages\n- **Member Management:** Add, modify, delete members and subscriptions\n- **Subscription Management:** Create, modify, delete membership tiers\n- **Comment Management:** Reply to, approve, delete comments\n- **User Management:** Invite, modify, delete users\n- **Media Management:** Upload images and files (affects storage)\n- **Site Configuration:** Modify newsletters and settings\n\n**Published content is IMMEDIATELY PUBLIC** - be extra careful with publish operations.\n\n**Security Best Practices:**\n- **Store API keys securely** - Use 1Password CLI or secure env vars\n- **Review before publishing** - Always check content before making it public\n- **Never commit keys** - Keep credentials out of version control\n- **Rotate keys regularly** - Create new integrations every 90 days\n- **Use dedicated integrations** - Separate keys for different use cases\n- **Test on staging first** - Use a test Ghost site when possible\n\n**Admin API Key Scope:**\nGhost Admin API keys have **no scoping options** - they provide full access to everything. There are no read-only keys.\n\n**Operation Types:**\n\n**Read-Only Operations** (✅ Safe):\n- List posts, pages, tags, members, tiers, newsletters, comments\n- Get analytics and member stats\n- All GET requests\n\n**Destructive Operations** (⚠️ Modify or delete data, may be public):\n- Create\u002Fupdate\u002Fdelete posts, pages, tags (POST, PUT, DELETE)\n- Publish\u002Funpublish\u002Fschedule posts (**makes content public**)\n- Create\u002Fupdate\u002Fdelete members, tiers, newsletters\n- Create replies, approve\u002Fdelete comments\n- Upload images (uses storage quota)\n- All POST, PUT, DELETE requests\n\nFor detailed operation documentation, see [api-reference.md](references\u002Fapi-reference.md).\n\n## Quick Setup\n\n1. **Get your Ghost Admin API credentials:**\n   - Ghost dashboard → Settings → Integrations\n   - Create a new \"Custom Integration\"\n   - Copy the **Admin API Key** and **API URL**\n\n2. **Store credentials securely:**\n\n   **Option A: Environment Variables (Recommended)**\n   ```bash\n   # Add to your shell profile (~\u002F.zshrc, ~\u002F.bashrc)\n   export GHOST_ADMIN_KEY=\"YOUR_ADMIN_API_KEY\"\n   export GHOST_API_URL=\"YOUR_GHOST_URL\"\n   ```\n\n   **API URL Examples (works with ALL hosting types):**\n   ```bash\n   # Ghost(Pro) hosted\n   export GHOST_API_URL=\"https:\u002F\u002Fyourblog.ghost.io\"\n   \n   # Self-hosted with reverse proxy (production)\n   export GHOST_API_URL=\"https:\u002F\u002Fblog.yourdomain.com\"\n   \n   # Self-hosted development (Ghost default port 2368)\n   export GHOST_API_URL=\"http:\u002F\u002Flocalhost:2368\"\n   \n   # Self-hosted with custom port\n   export GHOST_API_URL=\"https:\u002F\u002Fghost.example.com:8080\"\n   ```\n\n   **Important:**\n   - Always include protocol (`http:\u002F\u002F` or `https:\u002F\u002F`)\n   - Include `:PORT` if Ghost runs on non-standard port\n   - Do NOT include trailing slash\n   - Do NOT include `\u002Fghost\u002Fapi\u002Fadmin` (added automatically)\n\n   **Option B: Config Files**\n   ```bash\n   mkdir -p ~\u002F.config\u002Fghost\n   echo \"YOUR_ADMIN_API_KEY\" > ~\u002F.config\u002Fghost\u002Fapi_key\n   echo \"YOUR_GHOST_URL\" > ~\u002F.config\u002Fghost\u002Fapi_url\n   \n   # Secure the files (owner read-only)\n   chmod 600 ~\u002F.config\u002Fghost\u002Fapi_key\n   chmod 600 ~\u002F.config\u002Fghost\u002Fapi_url\n   ```\n\n   **Option C: 1Password CLI (Most Secure)**\n   ```bash\n   # Store key in 1Password\n   op item create --category=API_CREDENTIAL \\\n     --title=\"Ghost Admin API\" \\\n     admin_key[password]=\"YOUR_ADMIN_API_KEY\" \\\n     api_url[text]=\"YOUR_GHOST_URL\"\n\n   # Use in commands\n   export GHOST_ADMIN_KEY=$(op read \"op:\u002F\u002FPrivate\u002FGhost Admin API\u002Fadmin_key\")\n   export GHOST_API_URL=$(op read \"op:\u002F\u002FPrivate\u002FGhost Admin API\u002Fapi_url\")\n   ```\n\n   **Security Notes:**\n   - Keys provide **full site access** - protect them like passwords\n   - Rotate keys every 90 days (create new integration, revoke old)\n   - Never commit to git or share keys publicly\n   - Consider separate keys for production vs. staging\n   - **HTTPS recommended:** Use HTTPS for production (HTTP acceptable for localhost only)\n\n3. **Install dependencies:**\n   ```bash\n   cd ghost-cms-skill\u002Fscripts\n   npm install\n   ```\n\n   **Dependencies installed:**\n   - `form-data` (^4.0.5) - Multipart file uploads (theme ZIP files)\n   - `jsonwebtoken` (^9.0.3) - JWT token generation for Ghost Admin API authentication\n\n   **Optional dependencies** (install manually if needed):\n   - `gscan` (^5.2.4) - Official Ghost theme validator (from TryGhost)\n     - Only needed for theme validation feature\n     - Install with: `cd scripts && npm install gscan`\n\n   **All dependencies from public npm registry. No custom downloads.**\n\n4. **Test connection:**\n   See [setup.md](references\u002Fsetup.md) for detailed authentication and troubleshooting.\n\n## Tools & Utilities\n\n### Snippet Extractor\n\n**Purpose:** Migrate existing Ghost snippets to local library for programmatic use.\n\n**Why needed:** Ghost Admin API blocks snippet access (403 Forbidden) for integration tokens. This tool works around that limitation.\n\n**Usage:**\n```bash\n# Extract snippets from a specially-formatted draft post\nnode scripts\u002Fsnippet-extractor.js my-snippets-post\n\n# Validate format before extracting\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --validate\n\n# Preview without saving\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --dry-run\n\n# Custom marker prefix\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --marker \"This is:\"\n\n# Full help\nnode scripts\u002Fsnippet-extractor.js --help\n```\n\n**Workflow:**\n1. Create draft post in Ghost\n2. For each snippet: add paragraph marker (e.g., \"SNIPPET: name\" or \"This is: name\")\n3. Insert the snippet content below each marker\n4. Run extractor → all snippets saved to `snippets\u002Flibrary\u002F`\n\n**Features:**\n- ✅ Extracts all card types (bookmarks, callouts, images, markdown, HTML, etc.)\n- ✅ Preserves exact Lexical structure\n- ✅ Auto-detects credentials from `~\u002F.config\u002Fghost\u002F` or env vars\n- ✅ Supports custom marker formats\n- ✅ Dry-run and validation modes\n- ✅ Verbose output for debugging\n\n**Example:**\n```bash\n# User has 12 snippets in Ghost\n# Creates \"My Snippets\" draft with markers\n# Runs: node scripts\u002Fsnippet-extractor.js my-snippets --marker \"This is:\"\n# Result: All 12 snippets in library\u002F ready for use\n```\n\nSee `snippets\u002FREADME.md` for complete documentation.\n\n### Theme Manager\n\n**Purpose:** Upload, activate, switch, and manage Ghost themes programmatically.\n\n**Why needed:** Automate theme deployments, switch themes, manage theme versions.\n\n**Usage:**\n```bash\ncd scripts\n\n# List all installed themes\nnode theme-manager.js list\n\n# Upload theme ZIP\nnode theme-manager.js upload \u002Fpath\u002Fto\u002Ftheme.zip\n\n# Upload and activate immediately\nnode theme-manager.js upload \u002Fpath\u002Fto\u002Ftheme.zip --activate\n\n# Activate existing theme\nnode theme-manager.js activate theme-name\n\n# Download theme backup\nnode theme-manager.js download theme-name backup.zip\n\n# Delete theme (cannot delete active theme)\nnode theme-manager.js delete old-theme\n\n# Show current active theme\nnode theme-manager.js active\n```\n\n**Features:**\n- ✅ Upload custom themes from ZIP files\n- ✅ Switch between installed themes\n- ✅ Download theme backups\n- ✅ Delete unused themes\n- ✅ Validation and error handling\n- ✅ **Immediate activation** - theme changes are public instantly\n\n**⚠️ Important:**\n- Theme activation is **immediate and public** - site appearance changes instantly\n- Cannot delete the currently active theme (switch first)\n- Themes must be valid Ghost theme ZIP files\n\n**Workflow:**\n```bash\n# Safe theme switching with rollback\nnode theme-manager.js active              # Note current theme\nnode theme-manager.js activate new-theme  # Switch to new theme\n# Test site in browser\nnode theme-manager.js activate old-theme  # Rollback if needed\n```\n\nSee `references\u002Fthemes.md` for complete theme management documentation and best practices.\n\n### Theme Validator\n\n**Purpose:** Validate Ghost themes before uploading using official gscan validator.\n\n**⚠️ Optional Feature:** Requires `gscan` package. Install with:\n```bash\ncd scripts\nnpm install gscan\n```\n\n**Why needed:** Catch errors early - missing files, invalid syntax, deprecated helpers, version incompatibility.\n\n**Usage:**\n```bash\ncd scripts\n\n# Validate theme directory\nnode theme-validator.js ~\u002Fthemes\u002Fmy-theme\u002F\n\n# Validate ZIP file  \nnode theme-validator.js theme.zip\n\n# Target specific Ghost version\nnode theme-validator.js theme.zip --version v6\n\n# JSON output for CI\u002FCD\nnode theme-validator.js theme.zip --json\n\n# Show only errors (hide warnings)\nnode theme-validator.js theme.zip --errors-only\n```\n\n**Features:**\n- ✅ Official Ghost validator (gscan from TryGhost)\n- ✅ Same validation as Ghost Admin\n- ✅ Validates directories or ZIP files\n- ✅ Ghost v5\u002Fv6 compatibility checking\n- ✅ Finds deprecated helpers and syntax errors\n- ✅ CI\u002FCD integration (JSON output, exit codes)\n- ✅ Categorized issues (errors, warnings, recommendations)\n\n**Validation levels:**\n- **Errors** - Must fix before upload (theme will be rejected)\n- **Warnings** - Should fix for best compatibility\n- **Recommendations** - Nice to have (best practices)\n\n**Safe deployment workflow:**\n```bash\n# 1. Validate before upload\nnode theme-validator.js my-theme.zip\n\n# 2. Fix any errors\n\n# 3. Re-validate\nnode theme-validator.js my-theme.zip\n\n# 4. Upload when clean\nnode theme-manager.js upload my-theme.zip\n```\n\n**CI\u002FCD integration:**\n```bash\nnode theme-validator.js theme.zip --json\nif [ $? -eq 0 ]; then\n  node theme-manager.js upload theme.zip --activate\nfi\n```\n\n**Exit codes:** 0 = valid, 1 = errors found, 2 = invalid arguments\n\nSee `references\u002Fthemes.md` for complete validation documentation and common error fixes.\n\n---\n\n## Core Operations\n\nThis skill covers all major Ghost operations. Navigate to the relevant reference for detailed guidance:\n\n### Content Management\n**When to use:** Creating drafts, publishing posts, scheduling content, managing pages\n\nSee **[content.md](references\u002Fcontent.md)** for:\n- Creating new posts (drafts)\n- Publishing and scheduling posts\n- Updating existing content\n- Managing tags, featured images, metadata\n- Working with pages vs posts\n\nSee **[lexical-cards.md](references\u002Flexical-cards.md)** for:\n- **Complete Lexical card type reference** (23 documented types)\n- Most comprehensive Ghost Lexical documentation available\n- Full JSON structures with field references\n- Video, audio, file uploads, buttons, toggles, embeds\n- Product cards, headers, call-to-action, paywall\n- Member visibility and content personalization\n\n**⚠️ Ghost Snippets Limitation:**\n\nGhost's native snippet feature (reusable content blocks saved in the editor) **cannot be accessed via the Admin API** with integration tokens (403 Forbidden). This means:\n\n- ❌ Cannot list available snippets\n- ❌ Cannot fetch snippet content\n- ❌ Cannot programmatically use author's existing snippets\n\n**Solution: Automated Snippet Extraction**\n\nThe skill includes a **snippet extractor tool** that migrates Ghost snippets to local files:\n\n1. **Create extraction post** in Ghost with all snippets (one-time setup)\n2. **Run extractor:** `node scripts\u002Fsnippet-extractor.js post-slug`\n3. **Done!** All snippets saved to `snippets\u002Flibrary\u002F` for programmatic use\n\n**Commands:**\n```bash\n# Extract snippets (auto-detects credentials from ~\u002F.config\u002Fghost\u002F)\nnode scripts\u002Fsnippet-extractor.js my-snippets-post\n\n# Validate format before extracting\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --validate\n\n# Preview without saving\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --dry-run\n\n# Custom marker format\nnode scripts\u002Fsnippet-extractor.js my-snippets-post --marker \"This is:\"\n\n# Full help\nnode scripts\u002Fsnippet-extractor.js --help\n```\n\n**Benefits:**\n- ✅ Migrate all existing Ghost snippets in seconds\n- ✅ Preserves exact Lexical structure (bookmarks, callouts, images, etc.)\n- ✅ Git version control\n- ✅ Use programmatically in automated posts\n- ✅ Works with any card types\n\nSee `snippets\u002FREADME.md` for complete documentation on extraction workflow and local snippet usage.\n\n### Analytics & Insights\n**When to use:** Checking subscriber counts, popular content, traffic trends\n\nSee **[analytics.md](references\u002Fanalytics.md)** for:\n- Subscriber growth and counts\n- Most popular posts (views, engagement)\n- Tag\u002Ftopic performance over time\n- Member tier distribution\n\n### Comments & Engagement\n**When to use:** Responding to comments, moderating discussions\n\nSee **[comments.md](references\u002Fcomments.md)** for:\n- Listing pending\u002Funanswered comments\n- Responding to comments\n- Comment moderation\n\n### Members & Subscribers\n**When to use:** Managing subscriber tiers, member access, premium content\n\nSee **[members.md](references\u002Fmembers.md)** for:\n- Subscriber tier management\n- Member-only content settings\n- Recent subscriber activity\n- Subscription status\n\n### Newsletters\n**When to use:** Managing newsletter settings, email campaigns\n\nSee **[newsletters.md](references\u002Fnewsletters.md)** for:\n- Newsletter configuration\n- Sending newsletters\n- Subscriber email settings\n\n## API Reference\n\nFor advanced operations or endpoint details, see **[api-reference.md](references\u002Fapi-reference.md)**.\n\n## Common Workflows\n\n**Draft → Notion → Ghost:**\n1. Draft content collaboratively in Notion\n2. Finalize content\n3. Use this skill to copy to Ghost as draft\n4. Review in Ghost admin\n5. Schedule or publish\n\n**Weekly content series:**\n1. \"Navi, write and publish a unique weekly post about [topic from our discussions this week]\"\n2. Skill creates post, sets author to \"Navi\", publishes automatically\n\n**Comment management:**\n1. \"Are there any pending comments?\"\n2. Review list of comments with post titles\n3. \"Respond to comment #123 with [response]\"\n\n**Analytics check:**\n1. \"What tags have been most popular in the past 6 months?\"\n2. \"How many new subscribers this month?\"\n3. \"When was my last subscriber-exclusive post?\"\n",{"name":5,"author":24,"homepage":25,"metadata":26,"repository":25,"description":7},"Chris Giddings","https:\u002F\u002Fgithub.com\u002Fchrisagiddings\u002Fmoltbot-ghost-skill",{"openclaw":27},{"install":28,"requires":35,"primaryEnv":37,"credentials":41,"capabilities":57,"disable-model-invocation":53},{"type":29,"command":30,"directory":31,"dependencies":32},"npm","npm install","scripts",[33,34],"form-data@^4.0.5","jsonwebtoken@^9.0.3",{"env":36,"bins":39},[37,38],"GHOST_ADMIN_KEY","GHOST_API_URL",[40,29],"node",{"types":42},[43,49],{"type":44,"locations":45,"description":48},"file",[46,47],"~\u002F.config\u002Fghost\u002Fapi_key","~\u002F.config\u002Fghost\u002Fapi_url","Ghost Admin API credentials",{"type":50,"variables":51},"env",[52,55],{"name":37,"required":53,"description":54},true,"Ghost Admin API key (JWT)",{"name":38,"required":53,"description":56},"Ghost site URL (Ghost Pro OR self-hosted, include :PORT if needed)",[58,59,60,61,62,63,64,65],"content-management","member-management","subscription-management","comment-management","user-management","media-management","destructive-operations","public-publishing","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fchrisagiddings\u002Fghost-cms",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":76,"prompt":86,"zipAvailable":53},[77,80,83],{"tool":78,"command":79},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill ghost-cms-skill",{"tool":81,"command":82},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill ghost-cms-skill",{"tool":84,"command":85},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill ghost-cms-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fchrisagiddings\u002Fghost-cms\u002FSKILL.md",[],[89,97,104,111,118,125],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":96},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":96},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":96},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":96},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":96},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":96},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]