blog-writer

name

blog-writer

description

Generate SEO-optimised, bilingual blog articles with featured images, in-article photography, and distinctive per-article design. Articles are drafted and edited as markdown in docs/{lang}/blog/{slug}.md. On instruction, builds Astro blog pages from those markdown files. Works for any client website and any topic. Use when the user says "write a blog article", "create a blog post", "publish a blog", "write about [topic]", or wants to add content to the blog section.

Blog Writer

Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, [phone].

Use when

• The task matches this domain: Generate SEO-optimised, bilingual blog articles with featured images, in-article photography, and distinctive per-article design. Articles are drafted and edited as markdown in docs/{lang}/blog/{slug}.md. On instruction, builds Astro blog pages from those markdown files. Works for any client website and any topic. Use when the user says "write a blog article", "create a blog post", "publish a blog", "write about [topic]", or wants to add content to the blog section.
• The user needs domain-specific strategy, writing, or planning in this area.

Do not use when

• Another skill is clearly narrower and better matched to the request.
• The task is unrelated to this domain or needs direct implementation instead.

Required inputs

• Business context, target audience, and the artifact or decision being developed.
• Any existing materials, constraints, or supporting references already available.

Workflow

1. Read the current business context and the concrete task to solve.
2. Use only the relevant detailed guidance and references for the request at hand.
3. For premium, revenue-critical, or authority-building articles, apply premium-commercial-writing so the article has a buyer question, authority role, SEO/GEO intent, proof, useful examples, and a next step.
4. Produce the strategy, writing, or framework output this skill is responsible for.
5. Check the result for clarity, realism, and handoff readiness.

Quality standards

• Outputs must be specific, usable, and grounded in the available evidence.
• Recommendations should support follow-on execution instead of staying abstract.
• The result should remain consistent with the broader repository system.

Anti-patterns

• Do not produce generic framework dumps with no decision made.
• Do not invent facts to complete the output.
• Do not ignore the actual audience, offer, or business constraints.

Outputs

• Strategy notes, writing deliverables, framework outputs, or implementation-facing recommendations.

References

• Start with references/legacy-guidance.md when you need the preserved detailed instructions from the previous skill version.
• Use references/series-and-launch-engine.md when the article is part of a campaign, launch, authority sequence, or deliberate conversion pathway instead of a standalone post.
• Use ../premium-commercial-writing/references/blog-and-authority-writing.md when an article must support topical authority, buyer education, SEO/GEO visibility, sales enablement, or premium positioning.
• Use ../premium-commercial-writing/references/seo-ai-search-writing.md when the article needs answer blocks, entity clarity, AI-search usefulness, or schema handoff notes.
• Read only the specific files under references/ that match the current task instead of loading the whole directory.
• This skill has no bundled scripts by default; keep execution focused on the documented workflow and any existing project files.

Notes

• Treat this SKILL.md as the portable execution layer for both Claude Code and Codex.
• Preserve existing project behavior unless the current task explicitly requires a change.