Agent skill · Code Review & Quality

econ-write

Expert economics paper writing assistant synthesizing advice from 50+ top guides by Cochrane, McCloskey, Shapiro, Head, Bellemare, Goldin, Glaeser, Kremer, and other leading economists. USE THIS SKILL whenever the user writes, edits, reviews, rewrites, or structures any economics paper, thesis, job market paper, abstract, introduction, conclusion, results section, literature review, or referee response. Also handles LaTeX formatting, presentations, and paper audits. Covers all paper types (applied, theory, structural, mixed) and all sections.

hanlulonggithub.com/hanlulongGitHub ↗
claude-codecodexMIT
Install
npx skills add hanlulong/econ-writing-skill --skill econ-write --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 5
SKILL.md size: 53 KB
Bundled scripts: none
Path: skills/econ-write/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 510
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

Review
written from the skill's own SKILL.md · Aug 5, 2026

What it does

The skill guides an AI to act as an economics paper writing assistant. It targets users who write, edit, review, rewrite, or structure economics papers, including theses, job market papers, abstracts, introductions, conclusions, results, literature reviews, or referee responses. It also handles LaTeX formatting, presentations, and paper audits. It covers applied, theory, structural, and mixed paper types.

How it works

The agent follows a set of core principles drawn from leading economists:

  • Prioritizes the reader, presenting the main result early and clearly.
  • Uses a triangular/newspaper style, placing the most important information first.
  • Centers on one central contribution, with everything else supporting it.
  • Advocates concrete findings with actual magnitudes and coefficients when applicable.
  • Encourages active voice, present tense, and simple language; minimizes unnecessary complexity.
  • Recommends drafting key sections (abstract, introduction) with attention to structure and flow, and tailoring guidance to the paper type (empirical, theory, structural).

For specific sections, it prescribes formatting and content focus:

  • Abstract: write last; include what it does, how, what it finds, why it matters; be concrete; include identification strategy for empirical work; limit to 100-150 words.
  • Introduction: craft a Hook, state Research Question, present Main Results with concrete findings, weave Literature/Value Added narrative, and finish with a Roadmap.
  • Model/Theory: start with a clear setup, present primitives and assumptions, define equilibrium, state propositions with intuition, and provide proofs or sketches as appropriate.
  • Data: specify data sources, sample construction, variable definitions, descriptive statistics, and data limitations upfront; present a summary statistics table.
  • Conclusion: summarize findings in a fresh way, outline policy or broader implications for empirical work, and propose concrete future directions.

The skill emphasizes concrete results, proper identification language for empirical work (e.g., DiD, IV, RDD, RCT), and careful documentation of data and methodology. It also mandates alignment with the paper type and cautions against overstatement or irrelevant literature references in sections like the abstract.

When to use it

Use whenever the user writes, edits, reviews, rewrites, or structures any economics paper, thesis, job market paper, abstract, introduction, conclusion, results section, literature review, or referee response. It also handles LaTeX formatting, presentations, and paper audits.

From the SKILL.md

You are an expert economics paper writing assistant. Your writing advice is synthesized from 50+ authoritative guides by Nobel laureates, Clark Medal winners, and leading economists including John Cochrane, Deirdre McCloskey, Jesse Shapiro, Keith Head, Marc Bellemare, Claudia Goldin, Lawrence Katz, Edward Glaeser, Michael Kremer, Plamen Nikolov, and others. When the user asks you to write or rewrite economics text, follow ALL the principles below. When drafting new text, apply every relevant rule. When rewriting existing text, identify violations and fix them while preserving the author's meaning and contribution. Adapt guidance to the paper type (applied empirical, theory, mixed theory-empirical, structural, descriptive). --- # CORE PRINCIPLES ## 1. The #1 Rule: Reader First "Keep track of what your reader knows and doesn't know." (Cochrane) Most readers are busy, impatient, and will skim. Make it easy for them to find your basic result quickly. Write for PhD economists who are NOT experts in your specific field. ## 2. Triangular / Newspaper Style Put the most important information FIRST, then fill in details. NEVER write in "joke" or "novel" style where the punchline comes at the

What's inside
Steps it walks through
  1. 1. The #1 Rule: Reader First
  2. 2. Triangular / Newspaper Style
  3. 3. One Central Contribution
  4. 4. Concrete, Not Abstract
  5. 5. Every Word Must Count
  6. 6. Active Voice, Present Tense
  7. 7. Simple > Complex
  8. Formula
  9. Structure (100-150 words)
  10. Rules
  11. Good Example
  12. Bad Example
  13. The Introduction Formula (Head / Evans / Bellemare)
  14. Paragraphs 1-2: THE HOOK (1-2 paragraphs)
Ships with 4 files
  • identification-strategies.md
  • latex-tips.md
  • review-checklist.md
  • specialized-tasks.md
About this skill
What does the econ-write skill do?

Expert economics paper writing assistant synthesizing advice from 50+ top guides by Cochrane, McCloskey, Shapiro, Head, Bellemare, Goldin, Glaeser, Kremer, and other leading economists. USE THIS SKILL whenever the user writes, edits, reviews, rewrites, or structures any economics paper, thesis, job market paper, abstract, introduction, conclusion, results section, literature review, or referee response. Also handles LaTeX formatting, presentations, and paper audits. Covers all paper types (applied, theory, structural, mixed) and all sections.

How do I install it?

Run `npx skills add hanlulong/econ-writing-skill --skill econ-write --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From hanlulong/econ-writing-skill, a repository with 510 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going