Write well-structured articles with outline-first workflow. Includes sentence variation, readability guidelines, and formatting best practices.
Limited to specific tools
Additional assets for this skill
This skill is limited to using the following tools:
name: content-writer description: Write well-structured articles with outline-first workflow. Includes sentence variation, readability guidelines, and formatting best practices. triggers:
Write clear, compelling articles using a two-mode workflow: outline first, then write section by section.
This skill operates in two modes:
Always start with outline mode before writing.
When the user provides a topic, create an outline before writing.
# [Title - max 70 characters, sentence case]
[Brief intro - 2-3 sentences introducing the topic. No "Introduction" heading.]
## [Section 1 heading]
[Description of what this section covers]
## [Section 2 heading]
[Description of what this section covers]
## [Section 3 heading]
[Description of what this section covers]
(Maximum 5 sections)
After the outline is approved, write one section at a time.
Write at a Flesch-Kincaid 8th-grade level:
Vary sentence length to create rhythm. Follow Gary Provost's lesson:
Bad example (monotonous):
This sentence has five words. Here are five more words. Five-word sentences are fine. But several together become monotonous. Listen to what is happening. The writing is getting boring.
Good example (musical):
Now listen. I vary the sentence length, and I create music.
Music.
The writing sings. It has a pleasant rhythm, a lilt, a harmony. I use short sentences. And I use sentences of medium length. And sometimes when I am certain the reader is rested, I will engage him with a sentence of considerable length, a sentence that burns with energy and builds with all the impetus of a crescendo.
So write with a combination of short, medium, and long sentences. Create a sound that pleases the reader's ear.
AI-generated text has telltale patterns. Avoid them to sound human.
Quick rules:
Common replacements:
| AI Word | Human Word |
|---|---|
| delve | explore, look at |
| landscape | field, area |
| leverage | use |
| pivotal | key, important |
| robust | strong, solid |
| comprehensive | complete, full |
Full reference: See references/AI_WRITING_TELLS.md in copy-editor skill for:
Return the outline as markdown. If the user specified a file path, write it there.
Return completed sections as markdown. Update the outline file with written content as you go.
content-optimizer)copy-editor)landing-page-builder)Use content-writer when... | Use other skills when... |
|---|---|
| Writing new articles from scratch | Editing existing copy (copy-editor) |
| Need structured outline first | Optimizing for SEO (content-optimizer) |
| Blog posts, guides, how-tos | Sales pages (landing-page-builder) |
| Educational content | Marketing copy (slogan-generator) |