From jf-skills
Polishes Journal of Finance manuscripts for general-interest exposition, tightening introductions and trimming hedging for the broad AFA readership.
How this skill is triggered — by the user, by Claude, or both
Slash command
/jf-skills:jf-writing-styleThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- The introduction does not deliver the question, finding, and magnitude in the first page
JF is the AFA flagship, read across asset pricing, corporate finance, banking, microstructure, and household finance by 8,000+ readers. Writing must be accessible to a finance reader outside your subfield while staying precise. The manuscript also faces a 60-page limit (≥1.5 spacing, 12-pt font), so lead with economics and offload technical depth to the Internet Appendix (bundled at the end of the same PDF; see jf-internet-appendix) rather than padding the body.
In order: (1) the question and why it matters — general-interest, concrete; (2) what you do — design/data/test in plain terms; (3) what you find — headline result with its economic magnitude in interpretable units; (4) why it is credible — the source of variation or the test; (5) contribution — the closest papers and your delta (see jf-literature-positioning); (6) brief roadmap. A reader who stops at page 3 should know the question, the answer, its size, and why to believe it.
Test a JF introduction by reading only page one and asking whether each element is present — the pass an out-of-subfield editor makes:
| By the bottom of page one, the reader knows… | If absent, the fix |
|---|---|
| The question and why it is first-order | Open with the stake, not the literature |
| What you do, in plain terms | One sentence on design/data/test, no notation |
| The headline finding | State the result before its caveats |
| Its economic magnitude in interpretable units | Add the bps / Sharpe gain / % of value |
| Why it is credible | Name the shock, instrument, or asset-pricing test |
A subfield draft typically fails on magnitude or credibility, assuming the reader cares.
Illustrative. A draft opens: "A large literature examines the cross-section of expected returns. We contribute to it." The result arrives three paragraphs later. The JF rewrite leads on page one:
"Firms exposed to supply-chain concentration earn 45 bps per month higher returns (Sharpe gain ≈ 0.4, illustrative). The premium survives standard factor adjustment and concentrates where arbitrage is costly, pointing to mispricing over risk."
The page-one reader now has the question, answer, size, and reason to believe; the survey citation moves into the contribution paragraph (jf-literature-positioning).
| Pushback on the prose | JF-specific fix |
|---|---|
| "I read three pages before the finding" | Move question + result + magnitude to page one |
| "Significant at 1%' is reported as the result" | Replace with the magnitude; keep the t-stat in a note |
| "The body is padded toward 60 pages" | Offload derivations/notation to the Internet Appendix |
【Question+finding+magnitude in first 3 pp?】yes / no
【Magnitude in economic units?】yes / no
【Accessible to non-specialist?】yes / no
【Notation moved to Internet Appendix?】yes / no
【Body ≤60 pp / hedging trimmed?】yes / no
【Next step】jf-submission
npx claudepluginhub brycewang-stanford/awesome-journal-skills --plugin jf-skillsPolishes JFE manuscript prose to be precise, evidence-forward, and free of hedging or overclaiming. Improves introduction structure and sentence discipline.
Polishes Journal of Banking & Finance manuscripts — sharpens prose, translates coefficients into economics, structures results paragraphs, and prepares references and metadata for Elsevier/JBF submission.
Polishes prose, abstracts, and introductions for QJE manuscripts so the big idea lands fast for a general-interest reader. Reflects QJE's house style.