writing-articles

Validate and refine blog article drafts in Markdown with frontmatter and punctuation rules.

Updated Dec 7, 2025
One-click install
npx skills add https://github.com/caiokf/homepage --skill writing-articles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-articles
Source: https://github.com/caiokf/homepage/tree/main/.claude/skills/writing-articles
Command: npx skills add https://github.com/caiokf/homepage --skill writing-articles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when creating or editing blog articles for the homepage - enforces humanized writing style, validates punctuation rules, and ensures content reads naturally without AI-typical patterns.

Core Features & Use Cases

  • Punctuation rules: enforces avoidance of em dashes and suggests natural alternatives.
  • Humanized writing guidelines: reduces AI-like phrasing, uses contractions, varied sentence lengths.
  • Content validation: ensures frontmatter structure, readability, and proper flow before publication.

Quick Start

Create an article in src/domain/articles/content/2025-12-27-example-article.md with proper frontmatter (title, date, tags, slug) and a natural, human voice following the rules, then run the validation checklist.

Frequently Asked Questions about writing-articles

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

FAQPage Schema
How do I write blog articles that don't sound like AI-generated content?

Humanized writing avoids AI-typical phrasing by using contractions, varying sentence length, and adopting a natural voice. This Skill enforces those guidelines alongside punctuation rules and readability checks to ensure your homepage blog articles read authentically without automated patterns.

What punctuation rules should I follow for blog articles?

Blog article punctuation should avoid em dashes and use natural alternatives instead. This Skill validates punctuation compliance, frontmatter structure, and content readability to ensure articles meet publication standards before going live.

How do I structure a blog article for maximum readability?

Blog articles need clear opening, body, and closing sections with natural flow and varied phrasing. This Skill validates that structure and applies readability checks to your markdown files in src/domain/articles/content/ following YYYY-MM-DD-slug.md naming.

Can I validate my blog article before publishing it?

Yes. This Skill runs validation on markdown files to check frontmatter (title, date, tags, slug), enforce humanized writing guidelines, reject em dashes, and verify content reads naturally—ensuring articles meet publication requirements.

What file format and structure do blog articles need?

Blog articles must be markdown files in src/domain/articles/content/ named YYYY-MM-DD-slug.md with proper frontmatter including title, date, tags, and slug. This Skill validates that structure and enforces content standards before acceptance.