subwave-news-dispatch

Write markdown news posts for the SUB/WAVE Dispatches page with correct frontmatter and structure.

1.3k|113|Updated May 11, 2026
One-click install
npx skills add https://github.com/perminder-klair/subwave --skill subwave-news-dispatch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subwave-news-dispatch
Source: https://github.com/perminder-klair/subwave/tree/main/.claude/skills/subwave-news-dispatch
Command: npx skills add https://github.com/perminder-klair/subwave --skill subwave-news-dispatch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing a news post for the SUB/WAVE /news page requires knowing the exact file location (web/content/news), the YAML frontmatter schema, the what/how/why body structure, and the editorial rules like the no-em-dash policy. This Skill encodes all of that so a dispatch is written correctly the first time and renders on the site without build errors.

Core Features & Use Cases

  • Correct file placement and naming: Creates posts at web/content/news/YYYY-MM-DD-slug.md, with the date prefix stripped from the URL and the slug taken from frontmatter or filename.
  • Frontmatter schema enforcement: Applies the title, date, category (Release, Feature, Fix, Announcement, Spotlight), version, author, and excerpt fields, and guards against YAML pitfalls like colons inside values that break the build.
  • Editorial structure and voice: Enforces the three-beat body (what's new, how to use it, why it helps), 150-350 word length, sentence-case headings, and a mandatory pass through the no-ai-slop skill before saving.
  • Use Case: After shipping a feature like PocketTTS voice cloning, ask for a dispatch and get a ready-to-build markdown file that appears on /news after the next static build.

Quick Start

Ask the assistant to write a news dispatch announcing a recently shipped SUB/WAVE feature, and it will produce the markdown file in web/content/news with valid frontmatter.

Frequently Asked Questions about subwave-news-dispatch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a news post to the SUB/WAVE website?

Create a markdown file at web/content/news/YYYY-MM-DD-slug.md with the required frontmatter (title, date, category, excerpt) and a short what/how/why body. The /news page reads files from disk and picks the post up automatically on the next build.

What frontmatter fields does a SUB/WAVE news article need?

Each dispatch needs title, date in ISO yyyy-mm-dd format, category (Release, Feature, Fix, Announcement, or Spotlight), and an excerpt used as the index deck and meta description. Version and author fields are optional.

Why does my news post fail the Next.js build?

Build failures usually come from YAML frontmatter errors, such as a colon followed by a space inside the title or excerpt value, which the parser reads as a nested key. Reword the value or wrap it in double quotes, then rerun npm run build.

How is the news article URL slug determined?

The slug comes from the frontmatter slug field if present, otherwise from the filename minus the YYYY-MM-DD date prefix. The date prefix only controls file sorting on disk and is stripped from the URL.

Does this skill publish or deploy the news post?

No, it only writes the markdown file to web/content/news. The post appears on /news after the next site build, and the sitemap picks it up automatically via getNewsSlugs.