writing-style

Writing Style — Structural Pattern Analysis

Purpose

A sentence or paragraph can look fine in isolation. When the same structural shape repeats across 1,000-3,000 words, the aggregate creates a mechanical feeling — even though no single instance is wrong. Linear readers miss this because they process sequentially and each paragraph clears the "is this well-written?" bar individually.

This analysis solves the forest-vs-trees problem. It decomposes every paragraph's structure, then aggregates the fingerprints to surface repetition invisible to linear reading.

How to Use

Invoke this skill using the Skill tool: swarm:writing-style. Pass the piece's text or file path as the args parameter. The skill returns a structured report. The lead relays the report to the editor for interpretation. Invoke during the review phase (required) or optionally during drafting.

The report is advisory, never gating. The editor applies editorial judgment to the data. The Economist escape clause applies: if a flagged pattern serves the piece, keep it and note why.

Analysis Process

Exclude from analysis: Table cells, comparison tables, and structured list items with deliberately parallel construction (numbered checklists, step-by-step procedures). These are exempt from construction density calculation but still included in named pattern counts. Report construction density both with and without these items so the editor has both numbers.

Introductory and concluding paragraphs adjacent to lists are NOT exempt — only the parallel list items themselves.

Pass 1: Structural Decomposition

For each body paragraph, classify:

1. Opening move — how the paragraph begins:

• claim: declarative assertion
• scenario: narrative with actors or concrete situation
• question: interrogative opening
• data: leads with a statistic or cited fact
• contrast: opens with negation or opposition
• definition: introduces or defines a term
• transition: bridges from previous section
• imperative: directive opening