jel-writing-style — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited jel-writing-style (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A JEL survey is read by non-specialist economists — smart, but not in this subfield. The voice is that of a trusted, fair expert teaching the field to a colleague from another area. Four qualities define it:
A JEL introduction differs from a research-paper intro. The arc:
frame the field (what it studies, why it matters to economists broadly) → why a synthesis is needed now (new evidence / method shift / policy salience) → the organizing question and the spine (the map the reader will be given) → what the survey concludes and the open questions (the payoff, stated up front) → roadmap (brief).
State the bottom line early. A survey that withholds its conclusions to a final section wastes the non-specialist's time and reads as indecisive.
A survey abstract describes what the survey does for the reader, not a single empirical finding: the field, why a synthesis now, the organizing idea, and the headline state-of-knowledge takeaway. Avoid "we estimate / we find a coefficient of…"; that is a primary-paper abstract. (Confirm any length/format limits in the AEA JEL style guide via jel-submission.)
JEL surveys are long, and length is a privilege, not a license. Every section must earn its pages by advancing the argument about the field; coverage for its own sake (the confirmatory tier of jel-comprehensiveness-and-balance) belongs in compact citation clusters, not in paragraph-length summaries. Use subsection summaries and a recurring return to the spine so a reader who puts the survey down can re-enter it without rereading.
【Opening arc】frame → why-now → question+spine → conclusions+open-questions → roadmap? Y/N
【Bottom line early】state of knowledge stated up front? Y/N
【Accessibility】intuition-first; jargon controlled; non-specialist can follow? Y/N
【Signposting】architecture mirrors spine; periodic cues? Y/N
【Synthesis prose】papers in dialogue, not listed? Y/N
【Abstract】survey-style (contribution to reader), not a single estimate? Y/N
【Next step】→ jel-classification-system (assign JEL codes) → jel-submission~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.