Agent skill

Economist Style

by TAJD in TAJD/economist-style-guide-plugin

Apply The Economist style guide to written content. An agent skill from TAJD/economist-style-guide-plugin.

MITAuto-check passedWriting & Content

Install Economist Style

skills CLI
$ npx skills add TAJD/economist-style-guide-plugin --skill economist-style -a claude-code

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

GitHub CLI
$ gh skill install TAJD/economist-style-guide-plugin economist-style --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/TAJD/economist-style-guide-plugin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/economist-style/skills/economist-style .claude/skills/economist-style && 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
economist-style
GitHub stars
126
Token cost
~1.6k tokens
SKILL.md length
766 words
Files
14
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Apply The Economist style guide to written content. An agent skill from TAJD/economist-style-guide-plugin.

  • Works in 12 steps: Load the Signature Rules → Detect Document Dialect → Structural Review → …
  • Editing markdown
  • SKILL.md covers Core Principles, Orwell's Six Elementary Rules, Tone: The "Do Nots" and Analysis Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Economist Style is an agent skill from TAJD/economist-style-guide-plugin. Apply The Economist style guide to written content. Use when editing markdown, HTML, documentation, or any written text that needs professional editing for clarity, precision, and brevity. Detects weasel words, fillers, passive voice, and style issues.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files (for example `reference/ABBREVIATIONS.md`, `reference/CAPITALIZATION.md` and `reference/CLARITY.md`).

It sits in Writing & Content. The repository describes itself as: Claude Code plugin that applies The Economist style guide - clarity, precision, brevity. Unofficial. The licence is MIT.

When your agent uses it

  • Editing markdown
  • Any written text that needs professional editing for clarity

Example prompts

  • “/economist-style”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Load the Signature Rules
  2. Detect Document Dialect
  3. Structural Review
  4. Clarity Analysis
  5. Precision Check
  6. Dialect Conventions (if applicable)
  7. Common Errors
  8. Punctuation Check
  9. Numbers and Figures
  10. Structure Review
  11. Tone Assessment
  12. Abbreviations (on-demand)

What it can do on your machine

Read from SKILL.md and the folder at commit cfb132d. 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

Economist Style loads about 1.6k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 766 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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 TAJD/economist-style-guide-plugin at commit cfb132d, republished under its MIT licence (© TAJD). 766 words, ~1,565 tokens.

Download SKILL.mdSave it as .claude/skills/economist-style/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
economist-style
description
Apply The Economist style guide to written content. Use when editing markdown, HTML, documentation, or any written text that needs professional editing for clarity, precision, and brevity. Detects weasel words, fillers, passive voice, and style issues.

The Economist Style Guide

Apply these principles to all written content, including markdown files, HTML, code documentation, and technical writing.

Core Principles

  1. Clarity first: Use short words, active voice, and concrete examples
  2. Precision: Replace vague quantifiers with specific numbers and facts
  3. Brevity: Choose concise over verbose expressions
  4. Dialect awareness: Match the document's existing spelling and conventions (British, American, etc.)

Orwell's Six Elementary Rules

The guide's introduction rests on George Orwell's six rules (from "Politics and the English Language", 1946): clarity of thought first, then say it as simply as possible.

  1. Never use a metaphor, simile or other figure of speech which you are used to seeing in print
  2. Never use a long word where a short one will do
  3. If it is possible to cut out a word, always cut it out
  4. Never use the passive where you can use the active
  5. Never use a foreign phrase, a scientific word or a jargon word if you can think of an everyday English equivalent
  6. Break any of these rules sooner than say anything outright barbarous

Tone: The "Do Nots"

In the spirit of the guide's introduction:

  • Do not be stuffy: Use everyday speech, not the language of lawyers or bureaucrats
  • Do not be hectoring or arrogant: Those who disagree are not necessarily stupid; persuade with evidence, not assertion
  • Do not be too pleased with yourself: Let analysis speak; avoid self-congratulation
  • Do not be too chatty: Maintain professional distance
  • Do not be too didactic: Guide, don't lecture
  • Get straight in and be lucid: No throat-clearing openings; edit ruthlessly; cut anything superfluous

Analysis Workflow

When reviewing text, follow this sequence:

0. Load the Signature Rules

Read reference/ECONOMIST-SIGNATURE.md first — a one-page distillation of the rules that make copy recognizably Economist (numbers, dates, commas, quotes, honorifics, headings). Most reviews need only this plus the quick checks below; load the detailed files only when a deeper check is warranted.

1. Detect Document Dialect

IMPORTANT: Before making any suggestions, detect the document's existing spelling dialect:

  • Look for spellings like "colour" vs "color", "organise" vs "organize"
  • Check date formats (1st January vs January 1st)
  • Observe punctuation style (single vs double quotes)
  • Match the document's existing conventions - do not impose a dialect
2. Structural Review
  • Check for buried ledes (main point should come first)
  • Verify logical flow and argument structure
  • Ensure each paragraph has a clear purpose
3. Clarity Analysis

For detailed passive voice and clarity rules, read reference/CLARITY.md

Quick checks:

  • Flag passive voice constructions
  • Identify jargon and suggest plain alternatives
  • Find unnecessarily complex words
  • Detect hedge words that weaken statements
4. Precision Check

For detailed precision rules, read reference/PRECISION.md

Quick checks:

  • Identify vague quantifiers ("many", "often", "significant")
  • Flag weasel words and empty fillers
  • Flag clichés and dead metaphors ("game-changer", "perfect storm")
  • Suggest specific numbers or evidence
  • Remove redundant phrases
Show full SKILL.md (295 more words)Show less
5. Dialect Conventions (if applicable)

Only if the user explicitly requests dialect checking, or if there are inconsistencies within the document, read reference/DIALECT-CONVENTIONS.md

6. Common Errors

For frequently encountered mistakes, read reference/COMMON-ERRORS.md

7. Punctuation Check

For detailed punctuation rules (commas, semicolons, dashes, quotation marks), read reference/PUNCTUATION.md

Quick checks:

  • Verify comma usage (serial comma, restrictive clauses)
  • Check dash and hyphen usage
  • Ensure consistent quotation mark style
8. Numbers and Figures

For number formatting guidelines, read reference/NUMBERS.md

Quick checks:

  • Spell out numbers one to ten, use numerals from 11
  • Verify percentage formatting (% symbol, percentage points vs percentages)
  • Check date and currency formatting
9. Structure Review

For document organisation guidelines, read reference/STRUCTURE.md

Quick checks:

  • Each paragraph has a clear topic sentence
  • Lead/opening hooks the reader
  • Logical flow from paragraph to paragraph
  • Conclusion adds value (not just summary)
10. Tone Assessment

For voice and register guidance, read reference/TONE.md

Quick checks:

  • Authoritative but not arrogant
  • Avoid excessive adjectives and intensifiers
  • Neutral language on contested issues
  • No preaching or lecturing
  • People: full name on first mention, honorific + surname after ("Ms Yellen")
11. Abbreviations (on-demand)

If the document contains abbreviations or acronyms, read reference/ABBREVIATIONS.md

12. Capitalisation (on-demand)

If there are capitalisation questions (titles, institutions, geographic terms), read reference/CAPITALIZATION.md

13. Special Contexts (on-demand)

For quotations, foreign words, lists, or tables, read reference/SPECIAL-CONTEXTS.md

14. Word Usage (on-demand)

For rulings on commonly misused words (aggravate, decimate, refute, unique...), read reference/WORDS.md

Output Format

When providing feedback:

  1. List issues by category (clarity, precision, dialect consistency if applicable)
  2. Provide line/paragraph references
  3. Show original text and suggested replacement
  4. Explain the reasoning briefly

Example:

**Clarity Issue** (Para 2, Line 3)
Original: "The data was analysed by the research team"
Suggested: "The research team analysed the data"
Reason: Active voice is clearer and more direct

When Not to Apply

  • Direct quotations (preserve original wording)
  • Code examples (unless in comments/documentation)
  • Technical terms with no plain alternative
  • Proper nouns and brand names
  • Established dialect/spelling patterns (match what's already there)

© TAJD, 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 13 other files in economist-style/skills/economist-style of TAJD/economist-style-guide-plugin.

  • SKILL.md
  • reference/ABBREVIATIONS.md
  • reference/CAPITALIZATION.md
  • reference/CLARITY.md
  • reference/COMMON-ERRORS.md
  • reference/DIALECT-CONVENTIONS.md
  • reference/ECONOMIST-SIGNATURE.md
  • reference/NUMBERS.md
  • reference/PRECISION.md
  • reference/PUNCTUATION.md
  • reference/SPECIAL-CONTEXTS.md
  • reference/STRUCTURE.md
  • reference/TONE.md
  • reference/WORDS.md

Open the folder on GitHubat commit cfb132d

Compare with similar skills

Economist Style 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.

Economist Style compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Economist Style this skillTAJD/economist-style-guide-plugin126—~1.6kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
HumanizerAzure-Samples/interview-coach-agent-framework17338 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
JavaScript Concept Fact Checkerleonardomso/33-js-concepts67k1 repos~5kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    173 GitHub starsUsed in 38 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • JavaScript Concept Fact Checker

    leonardomso/33-js-concepts

    Verifies the technical accuracy of JavaScript concept pages by checking code examples, MDN and ECMAScript claims and external links through a five-phase method.

    67k GitHub starsUsed in 1 repo~5k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Install Anti Slop

    trycompai/crm

    Install and configure the anti-slop Oxlint plugin in a local TypeScript or JavaScript repository.

    11k GitHub starsUsed in 1 repo~881 tokens
    Writing & ContentAuto-check passed

Questions about Economist Style

What does Economist Style do?

Apply The Economist style guide to written content. An agent skill from TAJD/economist-style-guide-plugin. Economist Style is an agent skill from TAJD/economist-style-guide-plugin. Apply The Economist style guide to written content.

When should I use Economist Style?

Economist Style fits situations like: editing markdown; any written text that needs professional editing for clarity.

How do I install Economist Style in Claude Code?

Run `npx skills add TAJD/economist-style-guide-plugin --skill economist-style -a claude-code`. Or copy the skill folder (economist-style/skills/economist-style in TAJD/economist-style-guide-plugin) into .claude/skills/economist-style in your project. Claude Code loads it when a task matches its description.

How do I install Economist Style in Codex?

Run `npx skills add TAJD/economist-style-guide-plugin --skill economist-style -a codex`. Or copy the skill folder (economist-style/skills/economist-style in TAJD/economist-style-guide-plugin) into .agents/skills/economist-style in your project. Codex loads it when a task matches its description.

Can I use Economist Style 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 TAJD/economist-style-guide-plugin --skill economist-style -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/economist-style, .gemini/skills/economist-style, .github/skills/economist-style and .opencode/skills/economist-style in your project.

What does Economist Style need to run?

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

Does Economist Style 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 Economist Style 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 Economist Style use?

Economist Style 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 Economist Style use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Economist Style?

Skills that share tags, products or a category with Economist Style: Social (coreyhaines31/marketingskills, 54k stars), Humanizer (Azure-Samples/interview-coach-agent-framework, 173 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars) and JavaScript Concept Fact Checker (leonardomso/33-js-concepts, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Economist Style?

TAJD (a GitHub user) maintains it in TAJD/economist-style-guide-plugin, which has 126 GitHub stars. The repository was last updated on August 1, 2026.

Source: TAJD/economist-style-guide-plugin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.