Blog CMS (OpenBlog)

OpenBlog is an open-source, Git-based CMS for blogs — an agent-native blog module mounted on product websites (typically /blog). Markdown in Git is the source of truth; Next.js renders list/post pages, RSS, sitemap, and JSON-LD.

Git is the CMS. Your coding agent is the admin.

This skill is the entry point. It routes to the right workflow, then reads the matching skill in this pack when present.

Not in scope: whole-site CMS, WordPress-style dashboards, site-wide SEO/GEO — pair with marketing-skills for growth workflows on the host site.

Install

# Entry skill only
npx skills add kostja94/openblog --skill blog-cms

# Recommended — entry + primary workflows
npx skills add kostja94/openblog --skill blog-cms integrate-product-site setup-blog-module

# Full pack (content ops included)
npx skills add kostja94/openblog --skill '*'

# List all skills in the repo
npx skills add kostja94/openblog --list

Repo: github.com/kostja94/openblog · Docs: INTEGRATION.md

When working inside the OpenBlog monorepo, read AGENTS.md and skill files under skills/ directly.

Step 1 — Route the user

Ask before editing files if the path is unclear:

OpenBlog has two common paths:
1. Existing product site → integrate /blog via INTEGRATION.md (recommended)
2. Try it first → npx create-openblog my-blog
Which applies to you? If you have a product site URL, share it.

Do not default to create-openblog when the user mentions an existing website, product URL, chrome, or navbar alignment.

Step 2 — Execute the path

A. Integrate on existing product site (primary)

Read integrate-product-site skill (or INTEGRATION.md).

Summary:

1. Choose pattern: subdirectory (yourproduct.com/blog) · monorepo merge · subdomain
2. Configure openblog.config.ts → chrome (logo, nav, footer, siteUrl)
3. Edit templates/next/src/chrome/site-chrome.ts if needed
4. Optional brand draft: npm run integrate -- --site https://yourproduct.com
5. Set env: SITEURL, DEPLOYMODE, BLOGBASEPATH
6. Gate: npm run validate:posts && npm run build

B. Greenfield scaffold

Read setup-blog-module skill.

npx create-openblog my-blog
cd my-blog && npm install && npm run dev

From monorepo: npm run create-openblog -- my-blog

Configure openblog.config.ts (site, theme, features, components.optional). Run npm run theme:sync after theme changes.

C. Content operations (optional)

Guardrail: create-post is not autonomous article generation — the user supplies content or a clear brief.

What OpenBlog provides

Optional features toggles: categories, tags, authors, RSS (see docs/features.md in repo).

Commands (monorepo or scaffold)

npm install
npm run dev              # → http://localhost:3000/blog
npm run validate:posts
npm run theme:sync
npm run build
npm run integrate -- --site https://yourproduct.com   # brand manifest draft

Out of scope

• Site-wide SEO audit, keyword research, GEO, content strategy → marketing-skills
• Marketing landing pages, docs hub, app UI
• Upstream PRs to OpenBlog (enterprise partners only) → CONTRIBUTING.md
• Scraping full product nav as React — copy from main repo or use inherit-monorepo chrome mode

Skill pack index