Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› jel-comprehensiveness-and-balance
jel-comprehensiveness-and-balance
GitHub用于校准JEL综述中完整性与选择性的平衡，确保对不同学派、作者及争议点的公平对待。通过文献分层和避免自我引用偏见，保证覆盖全面且重点突出，提升综述的客观性与权威性。
Trigger Scenarios
填充文献时不确定是否应引用所有内容或进行筛选
领域存在对立学派、活跃争议或相互冲突的经验结果
作为该领域贡献者，担心综述偏向自身工作
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jel-comprehensiveness-and-balance -g -y
SKILL.md
Frontmatter
{
"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
Version History
- 1839142 Current 2026-07-05 13:34
