Blog System Design

Design, build, or revise a technical blog and changelog as a product system, including its index, navigation, release history, heading links, search, responsive article layout, internal links, and social previews. Use when creating a publication, repairing a missing reading or sharing baseline, or changing shared blog presentation. Pair with ai-devblog for article writing.

201 stars 12 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add swyxio/skills --skill blog-system-design
Manual install
git clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/blog-system-design ~/.claude/skills/blog-system-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Blog System Design

Build a dense, readable technical publication rather than a marketing landing
page. Treat the index, post shell, navigation, typography, and explanatory
components as one reusable reading system.

## Keep the boundary clear

Use `ai-devblog` for choosing an article angle, writing and editing the prose,
selecting article-specific evidence, and publishing a post. Use this skill when
that work requires a new or changed shared layout, navigation model, taxonomy,
search behavior, or reusable component.

One article must not silently redesign the blog. Audit the existing system
first. Reuse a suitable established component; change the system deliberately
when the existing pattern is inadequate.

For a small static TypeScript blog with no suitable existing implementation,
adapt the [runnable starter](assets/static-blog-starter/README.md): it includes the
reading shell, search, stable anchors, related links and social-card generation.
Use the existing site's stack and shell when they already meet the need.

## Audit before designing

Inspect the rendered blog and its implementation at desktop, tablet, and mobile
sizes. Identify:

- content source and metadata schema;
- index, category, archive, and post routes;
- typography, spacing, reading width, and theme tokens;
- navigation, heading anchors, TOC behavior, and keyboard shortcuts;
- existing inline links, related-post metadata, and the archive's internal-link
  graph;
- search corpus and URL state;
Read the full skill on GitHub

Details

Skill name
blog-system-design
Repository
swyxio/skills
Path
blog-system-design/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Blog System Design skill do?

Design, build, or revise a technical blog and changelog as a product system, including its index, navigation, release history, heading links, search, responsive article layout, internal links, and social previews. Use when creating a publication, repairing a missing reading or sharing baseline, or changing shared blog presentation. Pair with ai-devblog for article writing.

How do I install the Blog System Design skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill blog-system-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Blog System Design popular?

It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.

Related skills

Accelevents API

201

swyxio/skills

Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.

Software Development12

Accelevents Speaker Sync

201

swyxio/skills

Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.

AI, LLMs & Agents12

Agents SDK

201

swyxio/skills

Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.

AI, LLMs & Agents12

Boron Letters

150

guia-matthieu/clawfu-skills

Master Gary Halbert's direct response copywriting principles from "The Boron Letters" (1984). The timeless fundamentals that separate pros from amateurs. Use when: Writing direct response copy (sales letters, emails, ads); Creating headlines that demand attention; Building mailing lists and segmentation; Improving copy through the A-pile test; Learning copywriting fundamentals from scratch

Writing & ContentIn 1 list32

Blind Spot Detective

191

jwynia/agent-skills

Systematically identify what's missing in non-fiction writing—both blind spots (inherent limitations) and blank spots (gaps that could be addressed). Use before finalizing non-fiction or when feedback feels incomplete.

Writing & Content24

Chapter Drafter

191

jwynia/agent-skills

Autonomously draft and polish chapters through multi-skill editorial passes. Use when you have a complete outline and want to produce a polished first draft with iterative refinement.

Writing & Content24

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.