write-article

Writes bilingual PT-BR and EN blog essays in MDX following a personal voice and anti-slop pipeline.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/CaioWF/caioweliton.dev --skill write-article-caiowf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-article
Source: https://github.com/CaioWF/caioweliton.dev/tree/main/.claude/skills/write-article
Command: npx skills add https://github.com/CaioWF/caioweliton.dev --skill write-article-caiowf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing blog posts with AI usually produces generic, slop-filled text that does not sound like the author. This Skill produces long-form blog essays in Caio's personal voice, in both PT-BR and EN, with verified facts, controlled analogy and humor budgets, and a strict anti-slop pass for each language. ## Core Features & Use Cases - Structured writing pipeline: angle and thesis selection, mandatory fact verification against the repo and design notes, skeleton built from approved exemplars, PT draft, EN rewrite, and per-language anti-slop passes. - Anti-slop reference tables: PT-BR and EN tables of AI-writing patterns (inflated vocabulary, negative parallelism, rule of three, vague attribution) to detect and rewrite before publishing. - Exemplar-based structure: a few-shot bank of approved posts with named structural moves (M1-M9) plus rejected moves and the reasons they failed. - MDX and diagram contract: frontmatter format, slug pairing across locales, and rules for optional inline SVG diagram components registered in mdx-components.tsx. - Use Case: Ask for a post about a technical decision in your project; the Skill proposes 2-3 angles, verifies every fact against the repository, drafts the PT essay, rewrites it in EN, and runs the full checklist on both files. ## Quick Start Ask the assistant to write a blog post about a chosen topic using the write-article skill, pick one of the proposed angles, and let it produce the paired PT and EN MDX files.

Frequently Asked Questions about write-article

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

FAQPage Schema
How do I write a blog post that does not sound like AI?

Use a defined voice source plus an anti-slop pass. This Skill reads a voice dictionary, builds the draft from approved exemplar structures, then scans the text against PT-BR and EN tables of AI-writing patterns and rewrites every match before finishing.

How to keep PT-BR and EN versions of a blog post in sync?

Both versions share the same slug, date, and section structure, stored as content/blog/pt/<slug>.mdx and content/blog/en/<slug>.mdx. The EN version is rewritten rather than translated, and each language gets its own independent anti-slop pass and checklist.

Does the skill verify facts before writing?

Yes, fact verification is a mandatory pipeline step. Numbers, dates, technical decisions, and personal habits must be checked against the repository, git log, design notes, or existing corpus; anything unverifiable is marked [VERIFICAR] instead of being invented.

Can I add diagrams to MDX blog posts?

Yes, when a figure explains a spatial or before/after relationship better than prose. Diagrams are inline SVG React components in components/blog, registered in mdx-components.tsx, using theme color tokens and aria-labels, with a locale prop for PT and EN copy.

What are the limitations of this writing skill?

It only writes files and never commits, pushes, or publishes. It is tuned to one specific author's voice and blog format, so the exemplars, tag vocabulary, and anti-slop tables are not generic defaults for other writers.