# building-blog

building-blog walks a project through adding a blog to a Next.js site with Sanity CMS: scans the repo, runs the questionnaire, drafts a plan, then implements it against a spec.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 61 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/web-development/building-blog
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/building-blog

## What it does

The skill takes on the setup work of putting a blog on a Next.js site that runs on Sanity. It starts by reading the host repo: `package.json`, `next.config`, locale folders, `tailwind.config`, `CLAUDE.md`, and any existing Sanity studio directory. Whatever it can detect gets filled in, so fewer questions land on you.

Next comes a questionnaire in `blog-technical-requirements.md` with 30+ questions about scope, SEO, locales, and page speed. In Claude Code it runs through `AskUserQuestion`, four at a time. Answers go into §1 Project Profile in a project-local copy under `docs/blog/`. Non-interactive runs fall back to shared defaults and list every assumption. Then you get a one-page plan with phases and open decisions, and nothing gets coded until you approve it.

Implementation follows the spec sections §2–§20, and the §19 checklist decides when the work is done. AI-generated hero images are steered by `blog-image-style-guide.md`, which describes generation with Gemini 3 Pro Image. MDX-only blogs without a CMS and documentation sites sit outside this skill: the patterns there are different.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill web-development/building-blog
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill building-blog -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/building-blog/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/building-blog/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill building-blog -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/building-blog/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill building-blog -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/building-blog/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates cli-tool/components/skills/web-development/building-blog
```

2. **Manually: put the files in place**
- File: `.github/skills/building-blog/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill building-blog -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/web-development/building-blog
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/building-blog/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/web-development/building-blog

## When to use it
- Add a blog to an existing Next.js + Sanity site
- Design the blog surface from scratch
- Collect technical and editorial requirements before a line of code
- Get a phased plan signed off first
- Pick a visual direction for AI-generated hero images

## Example prompts
- Add a blog to this Next.js + Sanity project
- Build the blog section from scratch, locales are already wired with `next-intl`
- Set up the blog with Sanity and suggest a hero image style

## Similar
- [sanity-best-practices](https://affpapa.org/en/nevibecode/skills/sanity-best-practices.md) — skill · 35000 installs
- [blog-writing-guide](https://affpapa.org/en/nevibecode/skills/blog-writing-guide.md) — skill · 3500 installs
- [sanity-live-cache-components](https://affpapa.org/en/nevibecode/skills/sanity-live-cache-components.md) — skill · 602 installs
- [blog](https://affpapa.org/en/nevibecode/skills/blog.md) — skill · 3000 installs
- [blog-analyze](https://affpapa.org/en/nevibecode/skills/blog-analyze.md) — skill · 2800 installs
- [shopify-blog-strategy](https://affpapa.org/en/nevibecode/skills/shopify-blog-strategy.md) — skill · 1200 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
