skills/bluebook/SKILL.md
This skill should be used when the user asks to “cite a case”, “format a citation”, “check Bluebook format”, “cite a statute”, “use id. or supra”, “format footnotes”, “cite a law review article”, or needs Bluebook 21st Edition citation guidance.
npx skillsauth add edwinhu/workflows bluebookInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Citation formatting for law reviews and legal scholarship per The Bluebook: A Uniform System of Citation (21st ed. 2020).
Announce: “I’m using the bluebook skill for citation formatting.”
Invoke this skill for:
For legal writing style: Use /writing-legal skill (Volokh)
For general writing: Use /writing skill (Strunk & White)
If you haven’t verified EVERY element of a citation, DO NOT write it.
Before writing ANY citation:
Guessing reporter volumes or page numbers is NOT HELPFUL — the user publishes with wrong citations that fail verification. Period. </EXTREMELY-IMPORTANT>
<EXTREMELY-IMPORTANT> ## IRON LAW #2: NO SHORT FORMS WITHOUT FULL CITATION FIRSTId., supra, and hereinafter REQUIRE a preceding full citation.
Before using ANY short form:
Using id. after intervening citations creates ambiguity. Delete and cite in full. </EXTREMELY-IMPORTANT>
<EXTREMELY-IMPORTANT> ## IRON LAW #3: FOOTNOTE VS. TEXT CITATION FORMATLaw review citations use footnote format (Rule 1). Court documents use text format (Bluepages).
FOOTNOTE (law reviews): Smith v. Jones, 500 U.S. 1, 5 (1991).
TEXT (court documents): Smith v. Jones, 500 U.S. 1, 5 (1991)
FOOTNOTE (statutes): 18 U.S.C. § 1001 (2018).
TEXT (statutes): 18 U.S.C. § 1001 (2018)
If writing for a law review and using text format conventions, DELETE and reformat. </EXTREMELY-IMPORTANT>
Before writing ANY citation:
1. IDENTIFY → What type of source? (case, statute, article, book)
2. LOCATE → Find the correct rule in Bluebook
3. VERIFY → Confirm ALL elements (volume, page, court, year)
4. FORMAT → Apply correct typeface and punctuation
5. CHECK → Does this match examples in the rule?
6. WRITE → Only after steps 1-5
Skipping any step produces unreliable citations.
Full citation:
Brown v. Board of Education, 347 U.S. 483, 495 (1954).
Short form (same footnote or five footnotes with no intervening):
Id. at 496.
Short form (different footnote, no intervening):
Brown, 347 U.S. at 497.
Short form (intervening citations):
Brown v. Board of Education, 347 U.S. at 498.
Full citation:
42 U.S.C. § 1983 (2018).
Multiple sections:
42 U.S.C. §§ 1983-1985 (2018).
Short form:
§ 1983 or id. § 1984
Full citation:
Cass R. Sunstein, *On the Expressive Function of Law*, 144 U. Pa. L. Rev. 2021, 2030 (1996).
Short form:
Sunstein, supra note 12, at 2035.
Full citation:
Richard A. Posner, Economic Analysis of Law 45 (9th ed. 2014).
Short form:
Posner, supra note 5, at 52.
| Source Type | Law Review Format | |-------------|-------------------| | Case names | Italics: Brown v. Board | | Book titles | Small caps: ECONOMIC ANALYSIS OF LAW | | Article titles | Italics: On the Expressive Function | | Journal names | Small caps: U. PA. L. REV. | | Periodical names (non-consecutively paginated) | Italics: N.Y. Times | | Statutes | Roman: 42 U.S.C. § 1983 |
| Signal | Meaning | Use When | |--------|---------|----------| | [no signal] | Direct support | Source directly states proposition | | See | Implicit support | Source supports but doesn’t directly state | | See, e.g., | One of several | Multiple sources support; citing representative | | Cf. | Analogous support | Source supports by analogy | | Compare ... with | Comparison | Sources illustrate through contrast | | See generally | Background | Source provides helpful background | | But see | Contradiction | Source contradicts proposition | | Contra | Direct contradiction | Source directly contradicts |
Within a single citation sentence, signals appear in this order:
For detailed rules, consult:
references/cases.md - Complete case citation rules (R. 10)references/statutes.md - Statutory and regulatory citations (R. 12-14)references/secondary-sources.md - Books, articles, treatises (R. 15-17)references/short-forms.md - Id., supra, hereinafter rules (R. 4)references/signals-parentheticals.md - Signals, parentheticals, order (R. 1)references/audit-patterns.md - Citation audit patterns and validationreferences/abbreviations.md - Bluebook abbreviation tablesFor edge cases, ambiguous rules, or additional context beyond the reference files, query the Bluebook 21e (2020) notebook:
# Notebook ID: f70a9976-b443-43d5-b5fd-43ff86b2b700
# Query specific Bluebook rules
/Users/vwh7mb/projects/nlm/nlm generate-chat f70a9976-b443-43d5-b5fd-43ff86b2b700 “How do I cite an unpublished opinion under Rule 10.8.1?”
# Get rule clarification
/Users/vwh7mb/projects/nlm/nlm generate-chat f70a9976-b443-43d5-b5fd-43ff86b2b700 “What are the typeface conventions for treaty citations?”
# Verify abbreviation tables
/Users/vwh7mb/projects/nlm/nlm generate-chat f70a9976-b443-43d5-b5fd-43ff86b2b700 “What is the correct abbreviation for ‘Environmental’ in journal names per Table T13?”
When to query the notebook:
Load the specific reference when:
Use with /writing-legal for complete legal scholarship workflow:
/bluebook formats citations correctly/writing-legal ensures argument structure and evidence handling/ai-anti-patterns catches AI writing indicators before submissionWhen to delete and restart:
How to restart:
Old: See Smith v. Jones, 500 U.S. at 15. Id. at 20. [intervening cite] Id. at 25.
New: See Smith v. Jones, 500 U.S. at 15. Id. at 20. [intervening cite] Smith, 500 U.S. at 25.
The third cite cannot use id. after an intervening citation.
development
Build the meeting-level proxy-voting × ownership panel on the WRDS SGE grid — ISS N-PX fund votes reduced to (item × block) direction cells, joined to institutional and mutual-fund ownership. Use when working with risk.voteanalysis_npx, N-PX fund-level votes, ISS→CRSP fund linking, index/passive/active voting blocks, or a proxy-voting panel that needs ownership attached.
development
Use when "CRSP CIZ", "CRSP v2", "CRSP flat file format 2.0", "crsp.dsf_v2 / msf_v2", "StkDlySecurityData", "StkMthSecurityData", "StkSecurityInfoHist", "stocknames_v2", "DlyRet / MthRet / DlyPrc / MthPrc", "SHRCD or EXCHCD equivalent in new CRSP", "SIZ to CIZ migration", "CRSP data after 2024", "CRSP delisting returns", "CRSP cumulative adjustment factors", "CRSP index INDNO / INDFAM", or any CRSP stock/index query where the legacy SIZ column names no longer exist.
development
Use when linking or deduping datasets by entity name rather than a shared key — 'fuzzy match', 'fuzzy name matching', 'entity resolution', 'record linkage', 'match company/person names', 'dedupe entity names', 'name-based join', 'bridge identifiers' (CIK ↔ permno ↔ gvkey ↔ wficn ↔ EIN ↔ personid), or any use of char n-gram TF-IDF, cosine similarity on names, `sparse_dot_topn`, or RapidFuzz at scale.
development
Use when building a publication-quality table in Python — 'regression table', 'results table', 'summary statistics table', 'etable', 'coefplot', 'great_tables', 'GT', 'gt table', 'format a table for the paper', 'export table to LaTeX/HTML', significance stars, spanners, or column formatting for a table headed into a paper, slide deck, or notebook.