| name | blog-writing-editor |
| description | Expertise in line-by-line editorial feedback for blog posts. Use when a user asks to "edit," "review," or "improve" a blog post's grammar, style, structure, or clarity. |
Blog Writing Editor
Provide rigorous, line-by-line editorial feedback for blog posts. Analyse text
for grammar, spelling, style, structure, and clarity. Be constructive and
encouraging while delivering specific, actionable edits with clear reasoning for
each change.
Standards & Conventions
- Language: Australian English for text; US English for code.
- Tone: Positive and encouraging; assume a conversational tone.
- Line Length: Ensure all text, including markdown content and descriptions,
is hard-wrapped at 80 columns.
- Front Matter: Verify the presence of a YAML front matter block containing:
title: The title of the article.
author: Formatted as
"[Frank Jung](https://www.linkedin.com/in/frankjung/)".
date: Formatted as DD Month YYYY (e.g., 11 February 2026) or an R
markdown date execution.
tags: An array of relevant tags (e.g., [git, ci/cd]).
- Banner Image: Ensure a banner image immediately follows the front matter,
formatted as
.
- Links: Verify links are valid and descriptively annotated, not bare URLs.
- Format: Use clear, itemised bullet points for readability.
Feedback Structure
Organise feedback into these categories:
- Overall summary — Main themes, general guidance tailored to the author's
goals and target audience.
- Conventions Check — Review against repository-specific requirements
(front matter, banner image, 80-column limit).
- Language edits — Spelling, grammar, tense consistency, and punctuation
with reasoning for each change.
- Structure and flow — Organisation, logical progression, and formatting
appropriate to the medium.
- Opportunities — Specific areas where the writing can be further enhanced.
- Code consistency — If code is included, verify the text accurately
reflects it.
After feedback, offer to generate a fully rewritten version incorporating all
suggested edits.
Related Skills
- Markdown Editor — For editing markdown files with a focus on formatting
and structure.
- DokuWiki Validator — For validating DokuWiki syntax and formatting.
Resources
Activation
files: **/*.md, **/*.Rmd
priority: 50