Use when calibrating completeness vs. selectivity and ensuring fairness across schools, authors, and controversies in a Journal of Economic Literature (JEL) survey — including not over-promoting the author's own work. Audits coverage and even-handedness; it does not design the framework (jel-organizing-framework) or write prose (jel-writing-style).
Scanned 9/5/2026
Install to Claude Code
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill jel-comprehensiveness-and-balance --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Jel Comprehensiveness And Balance?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/brycewang-stanford-jel-comprehensiveness-and-balance)More formats (shields.io, HTML) on the badges page.
---
name: jel-comprehensiveness-and-balance
description: Use when calibrating completeness vs. selectivity and ensuring fairness across schools, authors, and controversies in a Journal of Economic Literature (JEL) survey — including not over-promoting the author's own work. Audits coverage and even-handedness; it does not design the framework (jel-organizing-framework) or write prose (jel-writing-style).
---
# Comprehensiveness & Balance (jel-comprehensiveness-and-balance)
## When to trigger
- The framework is set and you are filling cells with the literature
- You are unsure whether to cite *everything* or curate
- The field has rival schools, a live controversy, or conflicting empirical results
- You are a contributor to this literature and worry the survey tilts toward your own work
## Completeness vs. selectivity: the JEL contract
A JEL survey must be **comprehensive in coverage** yet **selective in emphasis**. The reader should trust that nothing important is missing, while the prose foregrounds what matters. Resolve the tension by **tiering** the corpus:
| Tier | Treatment |
|------|-----------|
| **Foundational / field-defining** | discussed in the text, with what they established and their limits |
| **Important contributions** | grouped and weighed within the framework's cells; cited with their finding |
| **Confirmatory / incremental** | cited in clusters ("see also …") to demonstrate coverage without bloating prose |
| **Tangential** | cited only where they bear on a specific claim; not every adjacent paper belongs |
Comprehensiveness is proven by the *citation set* (the saturation log from `jel-literature-synthesis`); selectivity is exercised in the *prose*. A survey that discusses every paper at equal length has abdicated the editorial judgment that is its value.
## Fairness across schools, authors, and findings
JEL is the **survey of record**: its account of a debate becomes the field's shared reference. That obliges genuine even-handedness:
- **Steelman every camp.** State each school's strongest case in terms its proponents would accept *before* noting its weaknesses. Refute positions at their best, never at their worst.
- **Weigh, don't tally.** Conflicting results are reconciled by *credibility* (identification, data, replication) and by *what each estimates*, not by vote-counting "7 studies find positive, 4 negative."
- **Attribute ideas correctly.** Credit originators, not just popularizers; this is a recurring referee complaint.
- **Handle live controversies without resolving by fiat.** Lay out the disagreement, what evidence would settle it, and where the author's own read sits — labelled as the author's read, not as consensus.
## The self-citation trap
If you have published in the field, the survey must **not** read as a retrospective of your program. Guardrails:
- Your own work is cited at the tier its *importance to the field* warrants — no more.
- Rivals to your work are given their strongest statement.
- A reader who does not know who wrote the survey cannot tell from the emphasis.
- When the field disagrees with you, say so plainly and represent the other side fairly.
## Checklist
- [ ] Corpus tiered (foundational / important / confirmatory / tangential); prose emphasis matches tier
- [ ] Comprehensiveness provable from the citation set + saturation log
- [ ] Every rival school stated at its strongest before critique (steelman)
- [ ] Conflicting findings reconciled by credibility and estimand, not vote-counting
- [ ] Idea attribution traces to originators
- [ ] Live controversies presented with what evidence would settle them; author's read labelled as such
- [ ] Self-citation audited: own work at field-warranted tier; rivals steelmanned; emphasis is identity-blind
- [ ] No important author/school an informed referee could say was slighted or omitted
## Anti-patterns
- Comprehensiveness theatre: equal-length summaries of every paper (no editorial judgment)
- Vote-counting conflicting results instead of weighing credibility and estimand
- Strawmanning the camp the author disagrees with
- A survey that doubles as the author's CV (the most-punished JEL balance failure)
- Declaring a live controversy "resolved" by assertion rather than by laying out the evidentiary state
- Crediting the popularizer of an idea over its originator
## Output format
```
【Tiering】corpus split foundational/important/confirmatory/tangential? Y/N
【Comprehensiveness evidence】saturation log + citation set support "nothing important missing"? Y/N
【Steelman】each rival school stated at its strongest? Y/N
【Conflict handling】reconciled by credibility + estimand (not vote-count)? Y/N
【Controversy】evidence-to-settle stated; author's read labelled? Y/N
【Self-citation audit】own work at warranted tier; emphasis identity-blind? Y/N
【Next step】→ jel-tables-figures (who-found-what tables) → jel-writing-style
```
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!