gitwtfhub

wtf is ghost-headless-blog-skill?

kasuncfdo/ghost-headless-blog-skill — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TL;DR

A Claude Code skill that teaches the AI assistant to build and fix a headless Ghost CMS blog inside a Next.js website.

Mindmap

mindmap
  root((ghost-headless-blog-skill))
    What it does
      Adds Ghost blog to Next.js
      Debugs broken blog setups
      Provides code templates
    Tech stack
      TypeScript
      Next.js
      Ghost CMS
    Use cases
      Add blog to existing site
      Fix stale or empty blog
      Add author and tag pages
    Audience
      Vibe coders
      Next.js developers
    Setup
      Install as Claude plugin
      Or copy skill folder

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a headless Ghost blog to an existing Next.js website using Claude Code.

REASON 2

Debug a Ghost blog that shows zero posts or stale content.

REASON 3

Fix broken images or content cards in a Ghost powered blog.

REASON 4

Add author pages with bios and social links to a Ghost blog.

What's in the stack?

TypeScriptNext.jsGhost CMS

How it stacks up

kasuncfdo/ghost-headless-blog-skillcprecioso/tubecasterfarique/cursor-chat-explorer
Stars555
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-03-29
MaintenanceStale
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Next.js 15+ project, an existing Ghost site with a Content API key, and hosting that supports ISR revalidation.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This project is a skill for Claude Code, meaning it is a packaged set of instructions and code templates that teach the AI assistant how to add a blog to a website. Specifically, it helps set up a headless Ghost CMS blog inside a Next.js website. Ghost is a popular blogging platform, and headless means the blog's content is managed in Ghost but displayed using your own website's design instead of Ghost's own theme system. Once installed, Claude automatically uses this skill whenever someone asks for something like adding a Ghost powered blog to a site, or when troubleshooting an existing Ghost blog that shows no posts, has stale content, or has broken images or cards. Instead of guessing how to wire this up, Claude follows tested patterns already written out in the skill. The skill includes reference documents covering setup steps like configuring Ghost's admin area and environment variables, page routing patterns, and how to look up Ghost's own documentation. It also ships ready to use code templates: a client for talking to Ghost's content API, image handling code for faster loading, a webhook handler that refreshes cached pages the moment new content is published, and matching visual styles for Ghost's content blocks. Some of the more advanced features baked in include full tag and author archive pages, author bios with social links, search engine friendly metadata, and a sitemap that lists posts, tags, and authors. It is also designed to fail gracefully: if the Ghost connection is misconfigured, the site still builds successfully and shows an empty blog rather than crashing. Installing the skill can be done a few ways, including as a Claude Code plugin, through a general skills installer command that works across several AI coding tools, or by manually copying the skill files into a project or user folder. Using the generated blog requires a Next.js 15 or newer project, an actual Ghost site with an API key, and hosting that supports content refreshing on demand, such as Vercel. The project is released under the MIT license, a permissive license allowing free use, modification, and redistribution, including commercially, as long as the copyright notice is kept.

Yoink these prompts

Prompt 1
Add a headless Ghost blog at /blog to this Next.js site.
Prompt 2
My Ghost blog builds with 0 posts, help me debug it.
Prompt 3
Add author pages with bios and social links to my Ghost blog.
Prompt 4
Fix broken toggle cards or bookmarks rendering in my Next.js Ghost blog.

Frequently asked questions

wtf is ghost-headless-blog-skill?

A Claude Code skill that teaches the AI assistant to build and fix a headless Ghost CMS blog inside a Next.js website.

What language is ghost-headless-blog-skill written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Ghost CMS.

What license does ghost-headless-blog-skill use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ghost-headless-blog-skill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ghost-headless-blog-skill for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.