generate-blog-entry

Generate source-backed Markdown blog posts from git history, agent memory, and CI state.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/witwave-ai/witwave --skill generate-blog-entry-witwave-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-blog-entry
Source: https://github.com/witwave-ai/witwave/tree/main/.agents/self/piper/.claude/skills/generate-blog-entry
Command: npx skills add https://github.com/witwave-ai/witwave --skill generate-blog-entry-witwave-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing consistent, evidence-backed public blog posts about an autonomous agent team's work is time-consuming and prone to unverifiable claims. This Skill turns repo history, agent memory, CI state, and light internet research into a candid, human-readable field note ready for publication. ## Core Features & Use Cases - Evidence-driven research pass: Builds an evidence pack from recent posts, git history, GitHub Actions runs, agent memory files, and optional peer quotes before choosing a topic. - Three operating modes: Draft mode creates a reviewable post without committing, publish mode validates and pushes the post live, and defer mode records blockers when a topic cannot be verified. - Structured publishing contract: Produces a date-slugged Markdown file with website-compatible frontmatter, updates the posts.json manifest, and validates output with Prettier, JSON checks, and link checking. - Use Case: A scheduled weekly job invokes the Skill, which reviews the last 14 days of commits and agent memory, writes a 600-1,000 word field note about a coordination lesson, validates it, commits, and pushes it to the public blog. ## Quick Start Ask the agent to generate a blog entry about this week's most interesting development from the repository history and publish it.

Frequently Asked Questions about generate-blog-entry

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

FAQPage Schema
How do I generate a blog post from git history automatically?▼

Invoke the Skill in publish mode and it reviews 7-14 days of commits, CI runs, and agent memory to pick one story, then writes a Markdown post with frontmatter under social/posts/. It validates the output and commits it to the repository.

How do I draft a blog post without publishing it?▼

Use words like draft, review, or sketch in your request to trigger draft mode. The Skill creates the post with status ready and does not commit or push, leaving it for your review.

Can the blog post include quotes from other agents?▼

Yes, the Skill can request at most two peer quotes using a structured clarification message. Quotes must be fresh, attributed by first name, and are skipped entirely if the peer is unavailable or the answer is weak.

What happens when a blog topic cannot be verified?▼

The Skill enters defer mode instead of publishing. It writes notes to the agent's memory explaining what blocked the post, such as broken CI, unverifiable claims, or unrelated uncommitted changes in the source tree.

What validation runs before a blog post is published?▼

The Skill validates posts.json with Python's json.tool, checks formatting with Prettier, regenerates static pages with the site's build script, and runs a Markdown link checker. Only after all checks pass does it commit and push.