Blog Engine Agent Skill
MDX blog setup, RSS feed generation, sitemap.xml, structured data/JSON-LD, and related posts.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: MDX blog setup, RSS feed generation, sitemap.xml, structured data/JSON-LD, and related posts.
homepage: https://yepapi.com/skills/blog-engine
metadata:
tags: [blog, mdx, rss, sitemap]
---
# Blog Engine
## Rules
- MDX for content: `content/blog/[slug].mdx` — frontmatter with title, description, publishedAt, updatedAt, tags, image
- Dynamic routing: `app/blog/[slug]/page.tsx` — fetch MDX at build time, generate static params from file system
- RSS feed: generate `feed.xml` at `/rss.xml` — include title, description, pubDate, link, guid for each post — regenerate on build
- Sitemap: generate `sitemap.xml` with all blog URLs, lastmod dates, changefreq — submit to Google Search Console
- JSON-LD structured data: `Article` schema on every post — headline, datePublished, dateModified, author, image, publisher
- Related posts: tag-based matching — find posts sharing 2+ tags, fallback to most recent — display 3 related posts
- Table of contents: auto-generate from H2/H3 headings in MDX — render as sticky sidebar on desktop
- Pagination: 10 posts per page, `/blog/page/[num]` — include prev/next links for SEO
## Frontmatter Schema
```yaml
title: "Post Title"
description: "Meta description under 160 chars"
publishedAt: "2025-01-15"
updatedAt: "2025-02-01"
tags: ["nextjs", "react"]
image: "/blog/post-title/cover.jpg"
author: "Author Name"
```
## RSS Feed Pattern
Serve from API route or generate at build. Required fields: `<title>`, `<link>`, `<description>`, `<item>` per post with `<guid>`, `<pubDate>`.
## Avoid
- Missing `publishedAt` in frontmatter — breaks RSS and sorting
- No sitemap submission — Google won't discover new posts quickly
- Skipping JSON-LD — loses rich snippet eligibility
- Hardcoding related posts — use tag matching for automatic relevanceInstall
Why Use the Blog Engine Skill?
Without this skill, your AI guesses at blog engine patterns. It might hallucinate deprecated APIs, use outdated conventions, or miss best practices entirely. With it, your AI follows a proven ruleset — every suggestion aligns with current standards.
Drop this skill into your project and your AI instantly knows the rules. Better code suggestions, fewer errors, faster shipping.
Try These Prompts
These prompts work better with the Blog Engine skill installed. Your AI knows the context and writes code that fits.
"Build an MDX-powered blog with syntax highlighting, table of contents, and related posts"
"Create a blog with RSS feed, sitemap.xml, JSON-LD structured data, and social sharing cards"
"Add a blog engine with category pages, tag filtering, and search functionality"
Works Great With
Blog Engine skill — FAQ
It covers MDX blog setup, RSS feed generation, sitemap.xml, JSON-LD structured data, and related posts. Your AI builds SEO-optimized blog systems with all the metadata handled correctly.
Run `npx skills add YepAPI/skills --skill blog-engine` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
The skill defaults to MDX for developer blogs because it is version-controlled and supports React components. For content teams, it also covers headless CMS integration with proper content modeling.