jbaruch/blog-writer
Write developer blog posts from video transcripts, meeting notes, or rough ideas. Extracts narrative from source material, structures content with hooks and technical sections, formats code examples with placeholders, and checks drafts against 22 AI anti-patterns with structural variant detection, two-pass scanning, and rewrite auditing. Auto-updates anti-pattern list from Wikipedia before each session. Includes interactive onboarding to learn the author's voice from writing samples. Use this skill whenever the user wants to write a blog post, draft a blog, turn a transcript into a blog, work on blog content, or mentions "blog" in the context of content creation. Also trigger when the user provides a video transcript and wants written content derived from it, or when continuing work on a blog series.
94
Does it follow best practices?
Validation for skill structure
README.md
blog-writer
Write developer blog posts from video transcripts, meeting notes, or rough ideas.
What it does
Turns raw source material (video transcripts, meeting notes, rough outlines) into polished blog posts in the author's own voice. The skill follows a phased workflow: intake, clarification, editorial planning, first draft, and revision — with quality gates at each step.
Anti-pattern detection
Drafts are checked against 22 named AI writing anti-patterns, each with symptoms, examples, structural variants, and alternatives. The check runs in two passes:
- Surface scan — matches known pattern forms and their structural variants
- Skeleton scan — compares grammatical structure of adjacent sentences to catch patterns where the vocabulary differs but the grammar is identical
Every rewrite is re-audited against all 22 patterns before it's considered fixed.
The anti-pattern list auto-updates from Wikipedia: Signs of AI writing at the start of each session to stay current as LLM writing patterns evolve.
Persona system
The skill learns the author's voice through an interactive onboarding flow that analyzes
2-5 writing samples. Voice profile, bio template, product context, and example posts are
stored in persona/ and read fresh each session.
Series support
Blog series state (episode numbers, callbacks, open threads) is tracked across posts in
_blog-skill/series-tracker.md.
Getting started
Install via Tessl:
tessl install jbaruch/blog-writerOn first use, the skill runs the persona setup flow. After that, just tell it what you want to write about.