Agent skill

Structuring Articles

by rileyhilliard in rileyhilliard/claude-essentials

Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock).

MITAuto-check passedWriting & Content

Install Structuring Articles

skills CLI
$ npx skills add rileyhilliard/claude-essentials --skill structuring-articles -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rileyhilliard/claude-essentials structuring-articles --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rileyhilliard/claude-essentials.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ce/skills/structuring-articles .claude/skills/structuring-articles && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
structuring-articles
GitHub stars
130
Token cost
~1.6k tokens
SKILL.md length
869 words
Files
12 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock).

  • Outlining articles
  • SKILL.md covers How This Skill Relates to…, Framework Selection, Universal Elements and Sentence and Paragraph Rhythm, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Any narrative prose longer than a few paragraphs

What it does

Structuring Articles is an agent skill from rileyhilliard/claude-essentials. Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock). Use when writing or outlining articles, blog posts, essays, or any narrative prose longer than a few paragraphs.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/accordion.md`, `references/braided-narrative.md` and `references/diamond.md`).

It sits in Writing & Content, covering Blog and article writing. The licence is MIT.

When your agent uses it

  • Outlining articles
  • Any narrative prose longer than a few paragraphs

Example prompts

  • “Use the structuring-articles skill to select and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock)”
  • “/structuring-articles”

What it can do on your machine

Read from SKILL.md and the folder at commit 3a67a01. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Structuring Articles loads about 1.6k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 869 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rileyhilliard/claude-essentials at commit 3a67a01, republished under its MIT licence (© rileyhilliard). 869 words, ~1,619 tokens.

Download SKILL.mdSave it as .claude/skills/structuring-articles/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
structuring-articles
description
Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock). Use when writing or outlining articles, blog posts, essays, or any narrative prose longer than a few paragraphs.

Structuring Articles

Professional journalists don't just write — they select a structure that serves their material. A trend piece about remote work demands a different architecture than a breaking news story about a policy change. This skill helps you match content to the right framework, then execute it.

How This Skill Relates to Other Skills

This skill handles structure — the bones of an article. It tells you what goes where and why.

For voice, tone, and anti-AI rhetoric, load the writer skill. These two skills are designed to work together: structure from here, style from there.

For executive/strategy documents (board decks, business cases, market analysis), the strategy-writer skill is more appropriate — those follow their own conventions.


Framework Selection

Match the content to a framework before writing. The decision depends on three things: what kind of story is it, what's the strongest material you have, and how much space do you have?

You're writing about...Strongest materialFrameworkReference
A systemic trend or issue, and you have a compelling person affected by itA character whose experience illustrates the bigger pictureWSJ Formulareferences/wsj-formula.md
Breaking news, a new report, or a policy announcementThe headline fact — what just happened and why it mattersInverted Pyramidreferences/inverted-pyramid.md
A news event that also needs narrative depthBoth the headline fact AND a rich chronological story behind itHourglassreferences/hourglass.md
A sequential news event you want to narrate after the headlineThe headline fact AND a chronological sequence of what happenedMartini Glassreferences/martini-glass.md
A complex topic you want to ease readers into graduallyA specific person or scene AND broad research/dataDiamondreferences/diamond.md
A major event and you want to reconstruct how it unfoldedDetailed sourcing on what happened when — timestamps, scenes, dialogueTick-Tockreferences/tick-tock.md
A story with a dramatic climax momentA gripping scene you can open with before rewindingNine Structurereferences/nine-structure.md
Two parallel storylines that illuminate each otherMultiple characters or threads that intersectBraided Narrativereferences/braided-narrative.md
A data-driven story with a central human characterBoth quantitative data AND a compelling personal storyAccordionreferences/accordion.md
You're on deadline and need to organize material fastA pile of notes, quotes, and facts that need orderingFive Boxesreferences/five-boxes.md

If you're unsure, default to the WSJ Formula for features/essays or the Inverted Pyramid for news. They're the workhorses.

After selecting a framework, read the relevant reference file for the step-by-step structure.


Universal Elements

Every framework shares a few building blocks. These apply regardless of which structure you choose.

The Nut Graf

The single most important paragraph in any article. It answers "so what?" — why this story matters, why now, why the reader should care. If a reader skimmed only your headline and nut graf, they should grasp the central point.

In the WSJ Formula, the nut graf appears after the opening anecdote. In the Inverted Pyramid, it's the second or third paragraph. In every other structure, find its natural home — but it must exist, and it must appear early.

A nut graf that's missing or buried is the #1 reason a draft feels aimless.

See references/prose-craft.md for detailed guidance on writing nut grafs, plus ledes, transitions, kickers, data integration, and quote handling.

Show full SKILL.md (340 more words)Show less
The Lede

The opening that earns the reader's attention. Seven major types exist (summary, anecdotal, scene-setting, question, contrast, staccato, delayed) — each suited to different material. The framework you choose often implies the lede type: WSJ Formula calls for an anecdotal lede, Inverted Pyramid calls for a summary lede. But these aren't rigid rules.

See references/prose-craft.md for the full lede taxonomy.

The Kicker

The ending. Six types (circle, quote, echo, future-looking, experiential, surprise/revelation). The best endings are discovered during reporting, not manufactured afterward. If your planned ending isn't working, the real ending is probably a few paragraphs earlier.

See references/prose-craft.md for kicker guidance.


Sentence and Paragraph Rhythm

This is not about structure — it's about the texture of the prose within any structure. But it's so foundational it belongs here alongside framework selection.

Vary sentence length deliberately. Short sentences punch. Long sentences build complexity and momentum. Uniform sentence length is one of the clearest signals of machine-generated prose. Gary Provost's famous demonstration:

"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. The sound of it drones. It's like a stuck record. The ear demands some variety.

Now listen. I vary the sentence length, and I create music. Music. The writing sings. It has a pleasant rhythm, a lilt, a harmony."

Read your work aloud. If everything sounds the same length, it will feel monotonous regardless of content.

Paragraph length works the same way. Short paragraphs accelerate. Long paragraphs slow the reader for reflection. A one-sentence paragraph carries enormous weight — the white space around it says "this matters."


When NOT to Use This Skill

Not everything is an article. Skip this skill for:

  • Technical documentation, READMEs, API docs → use the writer skill's Engineer persona
  • Commit messages, PRs, changelogs → use the writer skill's Contributor persona
  • UI copy, error messages → use the writer skill's UX Writer persona
  • Executive strategy documents → use the strategy-writer skill
  • Quick social posts or comments → use the writer skill's Poster/LinkedIn persona

© rileyhilliard, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in plugins/ce/skills/structuring-articles of rileyhilliard/claude-essentials.

  • SKILL.md
  • references/accordion.md
  • references/braided-narrative.md
  • references/diamond.md
  • references/five-boxes.md
  • references/hourglass.md
  • references/inverted-pyramid.md
  • references/martini-glass.md
  • references/nine-structure.md
  • references/prose-craft.md
  • references/tick-tock.md
  • references/wsj-formula.md

Open the folder on GitHubat commit 3a67a01

Compare with similar skills

Structuring Articles next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Structuring Articles compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Structuring Articles this skillrileyhilliard/claude-essentials130—~1.6kAutomated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k2 repos~2.9kAutomated safety check: PassMIT
Figurevectorize-io/hindsight46k—~1.9kAutomated safety check: PassMIT
SepiaNanako0129/sepia3k—~3.6kAutomated safety check: PassMIT
Blog Post Draftingluongnv89/claude-howto42k—~2.1kAutomated safety check: PassMIT
Notion To Blogwasp-lang/wasp19k—~922Automated safety check: PassMIT

Similar skills

  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 2 repos~2.9k tokens
    Writing & ContentAuto-check passed
  • Figure

    vectorize-io/hindsight

    Draw an animated figure (boxes, arrows, moving data) as one self-contained SVG for a GitHub README, PR, issue or blog post.

    46k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Blog Post Drafting

    luongnv89/claude-howto

    Guides drafting a blog post from an idea and optional source material: research, brainstorming, outlining and version-tracked drafts, with user approval at each step.

    42k GitHub stars~2.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Notion To Blog

    wasp-lang/wasp

    Transfer a blog post from Notion to the Wasp blog. An agent skill from wasp-lang/wasp.

    19k GitHub stars~922 tokensUpdated today
    Writing & ContentAuto-check passed
  • WeChat Article Rewriting

    aiworkskills/wechat-article-skills

    Rewrites, continues, or polishes an existing WeChat article draft using a configurable language model, sending the full draft text to that endpoint.

    665 GitHub starsUsed in 1 repo~2.2k tokens
    Writing & ContentAuto-check passed

More from rileyhilliard/claude-essentials

All 17 skills in this repo
  • Handling Errors

    rileyhilliard/claude-essentials

    Prevents silent failures and context loss in error handling.

    130 GitHub stars~632 tokensUpdated 1 mo ago
    Auto-check passed
  • Planning Products

    rileyhilliard/claude-essentials

    Defines product features from a PM perspective (JTBD, competitive research, scope negotiation) before technical planning.

    130 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Writing Tests

    rileyhilliard/claude-essentials

    Writes behavior-focused tests using Testing Trophy model with real dependencies.

    130 GitHub stars~999 tokensUpdated 1 mo ago
    Auto-check passed
  • Optimizing Performance

    rileyhilliard/claude-essentials

    Measure-first performance optimization that balances gains against complexity.

    130 GitHub stars~470 tokensUpdated 1 mo ago
    Auto-check passed
  • Architecting Systems

    rileyhilliard/claude-essentials

    Guides clean, scalable system architecture during the build phase.

    130 GitHub stars~713 tokensUpdated 1 mo ago
    Auto-check passed
  • Design

    rileyhilliard/claude-essentials

    Enforces precise, minimal design for dashboards and admin interfaces.

    130 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Structuring Articles

What does Structuring Articles do?

Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock). Structuring Articles is an agent skill from rileyhilliard/claude-essentials. Selects and applies journalistic story structures (WSJ Formula, Inverted Pyramid, Hourglass, Tick-Tock).

When should I use Structuring Articles?

Structuring Articles fits situations like: outlining articles; any narrative prose longer than a few paragraphs.

How do I install Structuring Articles in Claude Code?

Run `npx skills add rileyhilliard/claude-essentials --skill structuring-articles -a claude-code`. Or copy the skill folder (plugins/ce/skills/structuring-articles in rileyhilliard/claude-essentials) into .claude/skills/structuring-articles in your project. Claude Code loads it when a task matches its description.

How do I install Structuring Articles in Codex?

Run `npx skills add rileyhilliard/claude-essentials --skill structuring-articles -a codex`. Or copy the skill folder (plugins/ce/skills/structuring-articles in rileyhilliard/claude-essentials) into .agents/skills/structuring-articles in your project. Codex loads it when a task matches its description.

Can I use Structuring Articles in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rileyhilliard/claude-essentials --skill structuring-articles -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/structuring-articles, .gemini/skills/structuring-articles, .github/skills/structuring-articles and .opencode/skills/structuring-articles in your project.

What does Structuring Articles need to run?

SKILL.md names no scripts, command-line tools or credentials: Structuring Articles is instructions for the agent only.

Does Structuring Articles access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Structuring Articles safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Structuring Articles use?

Structuring Articles is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Structuring Articles use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Structuring Articles?

Skills that share tags, products or a category with Structuring Articles: Khazix WeChat Article Writer (KKKKhazix/khazix-skills, 21k stars), Figure (vectorize-io/hindsight, 46k stars), Sepia (Nanako0129/sepia, 3k stars) and Blog Post Drafting (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Structuring Articles?

rileyhilliard (a GitHub user) maintains it in rileyhilliard/claude-essentials, which has 130 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on August 18, 2026.

Source: rileyhilliard/claude-essentials on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.