Use when revising prose to match The Yale Law Journal (YLJ) house style — clear, generalist-legible legal writing with a disciplined footnote-to-text balance. It governs voice and readability; it does not format citations (ylj-sources-and-bluebook) or sequence the argument (ylj-argument-structure).
Scanned 9/5/2026
Install to Claude Code
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-writing-style --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Ylj Writing Style?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/brycewang-stanford-ylj-writing-style)More formats (shields.io, HTML) on the badges page.
---
name: ylj-writing-style
description: Use when revising prose to match The Yale Law Journal (YLJ) house style — clear, generalist-legible legal writing with a disciplined footnote-to-text balance. It governs voice and readability; it does not format citations (ylj-sources-and-bluebook) or sequence the argument (ylj-argument-structure).
---
# Writing Style (ylj-writing-style)
YLJ prose is read by a **generalist legal audience**: scholars in other fields, judges, clerks, and
practitioners. The house standard is clear, confident legal writing where the **text carries the
argument** and footnotes carry the support. This skill polishes voice and readability; citation form
lives in `ylj-sources-and-bluebook` and structure in `ylj-argument-structure`.
## When to trigger
- The argument is sound but the prose is dense, hedged, or jargon-heavy
- A subfield reader follows it but a generalist editor would stall
- The footnotes have swallowed the argument (text is thin, footnotes are essays)
- Final polish pass before submission or before the Forum's faster turnaround
## House-style priorities
1. **Text-first.** The argument must be followable from the text alone; footnotes support and elaborate
but never *hide* a step the reader needs. If a key move lives only in a footnote, promote it.
2. **Generalist legibility.** Define terms of art on first use; don't assume the reader lives in your
doctrine. A clerk in a different field should follow the through-line.
3. **Plain, confident voice.** Prefer the active voice and concrete subjects. State the claim; don't
bury it under "it could be argued that." Hedge only where the law is genuinely uncertain.
4. **Topic sentences that argue.** Each paragraph opens with the claim it proves, not the subject it
touches. A reader skimming topic sentences should get the argument.
5. **Footnote discipline.** Substance belongs in text; footnotes hold cites, qualifications, and
genuinely tangential material. A footnote that is a second article competing with the text is a
YLJ-specific tell of an undisciplined draft.
## Sentence and paragraph craft
- Cut throat-clearing ("It is important to note that"); start with the subject and verb.
- One idea per sentence; break the 60-word doctrinal sentence into two.
- Signpost transitions with logic ("Because…," "Yet…," "If that is right, then…"), not filler.
- Use defined short forms for repeated case/statute names; don't restate the full caption every time.
## The footnote-to-text balance (a YLJ pressure point)
| Symptom | Fix |
|---------|-----|
| 40% of the page is footnote | Promote argument to text; cut footnote essays to cites + key qualifier |
| The reader must read footnotes to follow the argument | Move the load-bearing reasoning up into the text |
| A footnote runs longer than its paragraph | Split: keep the cite; relocate substance or delete |
| Stacked *see also* with no parentheticals | Trim; add explanatory parentheticals only where they earn space |
## Checklist
- [ ] Argument followable from text alone; no load-bearing reasoning stranded in footnotes
- [ ] Terms of art defined on first use; generalist can follow
- [ ] Active voice and concrete subjects predominate; hedging only where warranted
- [ ] Topic sentences state claims, not topics
- [ ] Footnotes are support, not parallel essays; no footnote dwarfs its paragraph
- [ ] Length within the track's encouraged cap (Article < 25k / Essay < 15k / Forum < 10k)
## Anti-patterns
- A "great footnotes" draft where the text is a skeleton and the argument lives below the line
- Subfield jargon and undefined acronyms that lock out a generalist editor
- Passive, over-hedged prose that never commits to the claim
- Topic sentences that announce a subject instead of advancing the argument
- Padding to hit a perceived "Article length" — over-length weighs against acceptance
## Output format
```
【Voice】active + confident? generalist-legible? Y/N
【Text-first】argument followable without footnotes? Y/N
【Footnote balance】any footnote dwarfing its paragraph? fixed? Y/N
【Length】within track cap? Y/N
【Next】ylj-placement-strategy (where/when to submit) → ylj-submission
```
## Supplementary resources
- [`../../resources/worked-examples/01-introduction.md`](../../resources/worked-examples/01-introduction.md) — a dense intro rewritten for generalist legibility
- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — YLJ length / style facts
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!