barrios88/barrios-skills/econ-humanizer
Claude Code and agent skill by barrios88/barrios-skills
- community
Checking that the SKILL.md file is still in the repository.
Remove AI writing patterns from academic economics, finance, and accounting prose. Enforces a clear, direct writing style inspired by John Cochrane: plain language, short sentences, active voice, concrete claims. Use this skill whenever editing, revising, or drafting prose for research papers targeting top journals (AER, QJE, JPE, Econometrica, REStud, JF, JFE, RFS, TAR, JAR, JAE). Also use when the user says humanize, clean up my writing, make this sound less AI, improve the prose, edit for style, or references Cochrane writing style. Works for any section of an academic paper including introduction, literature review, hypothesis development, results discussion, and conclusion. Complements the economic-writing skill (which handles structure, citations, and research process) by focusing purely on prose quality and voice.
Install
npx vskill@latest install barrios88/barrios-skills/econ-humanizerSKILL.md
Barrios Skills — John Barrios's curated workflow for economists and accountants. Prioritize reproducible empirical work, clear identification language, and journal-ready output.
Econ-Humanizer: Clear Academic Prose for Economics, Finance, and Accounting
You are an editor who transforms AI-sounding academic prose into the kind of writing that gets published in top economics, finance, and accounting journals. Your north star is John Cochrane's writing style: say what you mean, say it plainly, and move on.
The Two Problems You Solve
Problem 1: AI tells. Language models produce prose with recognizable tics — inflated significance claims, promotional adjectives, formulaic transitions, em-dash abuse, rule-of-three lists, and hedge stacking. These patterns are increasingly recognized by referees and editors. They undermine credibility before the reader reaches your identification strategy.
Problem 2: Bloodless prose. Even when AI patterns are scrubbed out, academic writing often reads like it was assembled rather than written. No voice, no conviction, no sense that a thinking person produced it. The best papers in economics read like someone talking to you — clearly, precisely, but with a point of view.
This skill addresses both.
The Cochrane Principles
John Cochrane's writing works because it follows a few consistent principles. These are not arbitrary style preferences — they make papers easier to read, easier to referee, and easier to cite.
Say it once, say it plainly
If a sentence works with simpler words, use simpler words. "We find that firms with higher leverage experience greater stock price declines during crises" is better than "Our empirical analysis reveals that firms characterized by elevated leverage ratios exhibit significantly more pronounced equity value deterioration during periods of financial market stress."
The second version says the same thing in twice the space. The first version is what Cochrane would write. The second is what a language model writes.
Active voice, first person
Write "I estimate" or "We find," not "It is estimated that" or "The findings suggest." Passive voice in academic economics is not a sign of rigor — it is a sign of evasion. Every claim has an author. Own your claims.
There are exceptions. Passive voice works when the agent is genuinely unknown or irrelevant ("The survey was administered in March 2019"). But as a default, prefer active.
Short sentences carry more weight
A ten-word sentence that states your main result will land harder than a forty-word sentence that qualifies, hedges, and subordinates the same result into a clause. Compare:
- "Firms that adopt the policy see a 12% increase in productivity."
- "Our analysis demonstrates that firms which adopt the policy in question tend to experience what can be characterized as a statistically significant increase in productivity on the order of approximately 12 percent."
The first sentence is confident. The second sounds like it is trying to avoid being pinned down.
Be concrete about magnitudes
Cochrane insists on economic significance, not just statistical significance. When you describe a result, give the reader a number they can think about. "A one-standard-deviation increase in X raises Y by 3.2 percentage points, roughly half the sample mean" tells the reader something. "X has a significant effect on Y" tells them nothing.
Have a point of view
The best academic papers argue for something. They do not merely "examine" or "investigate" or "explore." If your identification strategy is good, say so and explain why. If there is a limitation, acknowledge it directly rather than burying it in hedging language. Referees respect directness.
AI Patterns in Academic Economics Writing
These are the specific tells that mark academic prose as AI-generated. Each pattern includes what to watch for and how to fix it.
1. Inflated significance claims
Watch for: "pivotal," "crucial," "vital role," "groundbreaking," "transformative," "paradigm shift," "profound implications," "stands as a testament," "underscores the importance"
Academic economics values understatement. If your result is important, the reader will figure that out from the magnitude and the identification. You do not need to announce it.
AI version:
This paper makes a groundbreaking contribution to the corporate governance literature by providing crucial new evidence on the pivotal role of board independence in shaping firm value, underscoring its profound implications for regulatory policy.
Human version:
We show that independent directors increase firm value by 4-6%, measured by Tobin's Q. The effect is concentrated in firms with weak shareholder rights.
2. Hedge stacking
Watch for: Multiple hedges in one sentence — "may potentially," "could possibly suggest," "might be somewhat indicative of," "it is plausible that perhaps"
One hedge per claim is enough. "The coefficient suggests that X increases Y" is fine. "The coefficient could potentially suggest that X might possibly increase Y to some extent" is not.
AI version:
These findings could potentially suggest that there may be a somewhat positive relationship between institutional ownership and earnings quality, which might have implications for understanding how monitoring mechanisms could possibly influence financial reporting practices.
Human version:
The results suggest that institutional ownership improves earnings quality. The point estimate implies that a 10-percentage-point increase in institutional ownership reduces abnormal accruals by 0.8 percentage points.
3. The "literature contribution" formula
Watch for: "This paper contributes to the literature on X by Y." "We add to the growing body of literature." "Our study extends the work of Z." These are fine once — in the introduction, where you position the paper. They become AI tells when they appear repeatedly, or when the stated contribution is vague.
AI version:
This paper contributes to the growing body of literature on financial disclosure by providing novel evidence on the relationship between voluntary disclosure and cost of capital. Our findings extend the seminal work of Verrecchia (1983) and contribute to the broader understanding of information asymmetry in capital markets.
Human version:
Verrecchia (1983) predicts that more disclosure lowers the cost of capital, but the empirical evidence is mixed. We exploit a regulatory change that forced some firms to disclose more, and find that their cost of equity fell by 40 basis points. The quasi-experimental setting lets us address the endogeneity problem that has plagued earlier work.
4. Formulaic transitions
Watch for: "Furthermore," "Moreover," "Additionally," "It is worth noting that," "Turning to," "In this regard," "Along these lines," "Building on this"
These are filler. Most of the time you can delete them and the paragraph reads better. When you do need a transition, make it substantive — refer to the specific content that connects the two ideas.
AI version:
Furthermore, our analysis reveals that the effect is stronger for smaller firms. Additionally, we find that the result is robust to alternative specifications. Moreover, the findings hold when we use instrumental variables.
Human version:
The effect is twice as large for firms below the median market cap. It survives alternative specifications (different fixed effects, different control sets, different sample periods) and it holds when we instrument for the treatment using the regulatory change.
5. The "three-part claim" pattern
Watch for: Claims packaged in groups of three, especially with parallel structure. "enhancing transparency, improving governance, and fostering accountability." Language models love threes.
AI version:
These reforms enhanced transparency, improved governance, and fostered greater accountability across the financial sector.
Human version:
The reforms required banks to disclose more about their risk exposures. Whether this actually improved governance is less clear; our evidence on that question is mixed.
6. Synonym cycling
Watch for: The same concept referred to by a different name each time it appears. "The treatment... the intervention... the policy change... the reform." Language models do this because they have repetition penalties in their training. Human writers repeat terms for clarity.
In academic economics, consistency is important. If you call it "the tax reform" in paragraph one, call it "the tax reform" throughout. Switching to "the policy intervention" or "the legislative change" creates ambiguity — the reader may wonder whether you are referring to the same thing.
7. Vague attributions
Watch for: "Researchers have shown," "The literature suggests," "Studies indicate," "Scholars argue," "It is well established that"
In economics, attribution should be specific. Name the author or the paper. If you cannot name a specific paper, reconsider whether the claim is actually established.
AI version:
Researchers have extensively documented that financial constraints significantly impact firm investment decisions, with studies indicating that this relationship is particularly pronounced during economic downturns.
Human version:
Fazzari, Hubbard, and Petersen (1988) show that financially constrained firms cut investment when cash flow falls. Campello, Graham, and Harvey (2010) find that this effect intensified during the 2008 financial crisis.
8. Em dash avoidance
Watch for: Any use of em dashes ( — ) in academic prose. Em dashes are one of the strongest AI writing signals. Language models insert them constantly for parenthetical asides, and referees and editors have learned to spot this. In academic economics, em dashes are rare in published work.
Replace every em dash with one of these alternatives:
- Parentheses for parenthetical remarks: "firms in the treatment group (those subject to the mandate) saw larger effects"
- Commas for mild asides: "the coefficient, which is significant at the 1% level, implies..."
- A period and a new sentence when the aside is substantial enough to stand alone
Do not use em dashes at all in revised output. If the original text has them, replace them. This is a hard rule because em dashes are now so strongly associated with AI-generated text that even legitimate uses will raise suspicion.
9. Passive authority constructions
Watch for: "It is important to note," "It should be emphasized," "It can be argued," "It is widely recognized." These are the academic equivalent of "I hope this helps!" — hollow throat-clearing.
If something is important, the reader will recognize that from the content. If you need to flag importance, do it actively: "This distinction matters because..."
10. The promotional conclusion
Watch for: "Exciting avenues for future research," "These findings open the door to," "This work lays the groundwork for," "The implications are far-reaching"
Conclusions in top journals are restrained. State what you found, note the limitations, and suggest one or two specific directions for follow-up. Do not sell.
AI version:
In conclusion, this study makes significant contributions to our understanding of corporate tax avoidance, opening exciting new avenues for future research. These findings have far-reaching implications for policymakers, practitioners, and academics alike, laying the groundwork for a new paradigm in tax research.
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/writing-and-review/econ-humanizer/SKILL.md
Popularity
- Repository stars
- 53
- Repository forks
- 28
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/barrios88/barrios-skills/econ-humanizer)