writing-legal

Internal skill for academic legal writing. Loaded by /writing when style=legal. Based on Volokh's "Academic Legal Writing".

6 stars

Best use case

writing-legal is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Internal skill for academic legal writing. Loaded by /writing when style=legal. Based on Volokh's "Academic Legal Writing".

Teams using writing-legal should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/writing-legal/SKILL.md --create-dirs "https://raw.githubusercontent.com/edwinhu/workflows/main/skills/writing-legal/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/writing-legal/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How writing-legal Compares

Feature / Agentwriting-legalStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Internal skill for academic legal writing. Loaded by /writing when style=legal. Based on Volokh's "Academic Legal Writing".

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Academic Legal Writing

Style guide for law review articles, seminar papers, and legal scholarship based on Eugene Volokh's *Academic Legal Writing*.

## On Skill Load

**Step 1: Load base writing rules**

Read `${CLAUDE_SKILL_DIR}/../../skills/writing/SKILL.md` and follow its instructions.

**Step 2: Check for active workflow**

If `.planning/ACTIVE_WORKFLOW.md` exists and `workflow: writing`, update `style: legal`.

If no `.planning/PRECIS.md` exists in the project:
- Suggest: "No PRECIS.md found. Consider `/writing` to set up thesis, audience, and claims first."

**Step 3: Apply legal-specific rules below**

## When to Use

Invoke this skill for:
- Law review articles and student notes
- Seminar papers and legal scholarship
- Academic legal writing with footnotes
- Editing legal prose for structure and argument

**For general writing**: Use `/writing` skill (Strunk & White)
**For economics/finance**: Use `/writing-econ` skill (McCloskey)

## Required Skills

When generating Word documents (`.docx`), you MUST load the `/docx` skill first. The docx skill provides proper document manipulation capabilities.

## Template Requirement

**Template location:** `templates/law_review_template.docx`

When creating or converting a docx, load `references/formatting.md` for heading styles, body text styles, pandoc `--reference-doc` usage, and the document creation gate function.

## Enforcement

### IRON LAW #1: NO DOCX WITHOUT TEMPLATE FIRST

Before creating ANY Word document for legal writing:
1. Load the `/docx` skill
2. Copy `templates/law_review_template.docx` as the base
3. THEN add content to the template copy

If you created a blank docx without the template, DELETE IT and START OVER with the template.

### IRON LAW #2: NO CLAIM WITHOUT CONFRONTING COUNTERARGUMENTS

If your draft makes a prescriptive claim but doesn't address obvious objections, DELETE the section and START OVER. Legal scholarship requires anticipating and answering counterarguments, not ignoring them.

### IRON LAW #3: NO SECONDARY SOURCE CITATIONS FOR PRIMARY SOURCES

If you cite a case/statute/historical fact via an intermediate source (law review, treatise), DELETE the citation and READ THE ORIGINAL. Even Supreme Court opinions misstate precedents.

### Citation Facts

- Reviewers and editors check citations against the originals. A case cited from a headnote, a treatise, or training data — without reading the holding — is an unverified claim presented as fact, and one wrong citation destroys the author's credibility with every reader who catches it.

### Red Flags — STOP If About To:

- Open with "This article discusses..." → STOP. Hook with the concrete problem or controversy.
- Defer counterarguments to a later section → STOP. Confront objections in the section that makes the claim (Iron Law #2).
- Cite a case via a treatise or another case → STOP. Read and cite the original (Iron Law #3).
- Expand background beyond what the claim requires → STOP. Show the problem first; include only what proves the claim.

### Delete & Restart Pattern

**When to delete and restart:**

1. **Intro starts with "This article discusses"** → Delete, start with concrete problem
2. **Background exceeds proof section** → Delete excessive background
3. **Claim made without addressing objections** → Delete section, add counterargument confrontation
4. **Citation chain to primary source** → Delete citation, read and cite original
5. **Unpacked metaphor used as argument** → Delete, write actual logical argument

**How to restart:**

```
Old: "This article discusses privacy concerns in Fourth Amendment doctrine..."
New: "When police drones photograph backyards, does the Fourth Amendment require a warrant?
      Courts disagree, but three features of aerial surveillance suggest yes."
```

Start with CONCRETE QUESTION that matters, not abstract topic description.

## Law Review Article Structure

### Introduction

The introduction serves three functions:
1. Persuade readers to keep reading
2. Summarize the article for those who won't read it
3. Frame how readers interpret what follows

**Requirements:**
- Show the problem concretely with specific examples or hypotheticals
- State the claim clearly—what does the article contribute?
- Integrate the roadmap into the introduction, not as a separate paragraph
- Hook the reader: concrete question, engaging story, controversy, or argument to rebut

**Anti-patterns:**
- Starting with "This article discusses..."
- Separate table-of-contents paragraph (readers skip it)
- Historical background before establishing relevance
- Vague generalities about the importance of the topic

### Background Section

Synthesize precedents; do not summarize each case sequentially. Focus only on facts and rules necessary for the argument.

| Problem | Solution |
|---------|----------|
| Summarizing each case | Synthesize: "Courts generally hold X, except when Y" |
| Mini-treatise on the area | Only what's needed for the claim |
| 80% background, 20% claim | Balance must favor the original contribution |

### Proof of the Claim

For prescriptive claims: Show the proposal is both doctrinally sound AND good policy.

**Use a test suite:** Apply the proposal to concrete scenarios (easy cases, hard cases, edge cases) to demonstrate it works.

**Confront counterarguments:**
- Turn problems to advantage: refine the claim, acknowledge uncertainty
- Stay on offense—address objections without becoming defensive
- Acknowledge costs honestly; readers respect candor

**Connect to broader issues:**
- How does the claim relate to parallel debates?
- What subsidiary discoveries emerged?
- What questions remain for future research?

### Conclusion

Keep conclusions brief. The real work is rewriting the introduction after the draft is complete, ensuring it accurately reflects the article's contributions.

## Legal Argument Problems

Common logical problems in legal writing (see `references/volokh-distilled.md` for detailed examples):

| Problem | Issue |
|---------|-------|
| Categorical assertions | "Always" and "never" invite counterexamples |
| Unpacked metaphors | "Slippery slope" and "chilling effect" hide incomplete arguments |
| Missing logical pieces | Syllogisms that skip steps (subject to scrutiny ≠ fails scrutiny) |
| Universal criticisms | "Chilling effect" applies to most laws—explain why *this* one matters |
| Undefined abstractions | "Privacy," "paternalism," "democratic legitimacy" need definitions |
| "Arguably" as argument | Acknowledges controversy but doesn't make the case |

## Evidence and Citation

### Read Original Sources

Never rely on intermediate sources for cases, statutes, or historical facts. Even Supreme Court opinions misstate precedents.

| Source Type | Rule |
|-------------|------|
| Cases/statutes | Read the original; don't trust treatises or other cases |
| Historical facts | Go to history books, not law review articles citing them |
| Scientific studies | Read the study, not the article summarizing it |
| Newspapers | Unreliable; track down underlying documents |
| Wikipedia | Use to find sources, but cite originals |

### Be Precise with Terms

Avoid false synonyms: "murder" ≠ "homicide" ≠ "killing"; "foreign-born" ≠ "noncitizen"; "children" is ambiguous (0-14? 0-17? 0-24?).

Include necessary qualifiers: "*falsely* shouting fire" is quite different from "shouting fire."

### Be Explicit About Assumptions

Make clear when inferring:
- From correlation to causation
- From one time/place to another
- From one variable to another (arrest rate ≠ crime rate)

Acknowledge the inference and defend it; don't hide it.

### Handle Surveys Carefully

Surveys measure only what respondents said in response to specific questions. Valid surveys require:
- Random sampling (not self-selected, not convenience samples)
- High response rates (70%+)
- Sufficient sample size (1000+ for ±3% margin)
- Unambiguous questions

"Online survey" and "Internet poll" are almost sure signs of invalidity.

## Rhetoric and Tone

| Principle | Application |
|-----------|-------------|
| Understate criticism | "Mistaken" not "idiotic"—overstating raises the burden of proof |
| Attack arguments, not people | "This argument fails" not "Volokh is wrong" |
| Avoid caricature | Quote adherents, not critics, when explaining a position |

See `references/volokh-distilled.md` for extended discussion of rhetorical problems.

## Quick Reference

| Problem | Solution |
|---------|----------|
| "This article discusses X" | Hook with concrete problem |
| Case-by-case summaries | Synthesize precedents |
| Undefended metaphors | Unpack the concrete mechanism |
| "Arguably" / "raises concerns" | Give the actual argument |
| Relying on intermediate source | Read original case/study |
| "Many children" | Specify: "111 children age 0-17" |
| "Correlation shows causation" | Explain why inference is valid |
| "Volokh's argument is idiotic" | "This argument seems unsound" |

## Progressive Disclosure

For comprehensive guidance, consult:

### Reference Files

- **`references/formatting.md`** - Template formatting reference:
  - Heading hierarchy and Title Case rules
  - Body text styles
  - Document creation gate function (5-step)
  - Pandoc `--reference-doc` usage
  - Template facts and red flags

- **`references/volokh-distilled.md`** - Extended Volokh guidance covering:
  - Full logical problems taxonomy
  - Word and phrase problems to avoid
  - Extended evidence handling
  - Survey analysis methodology
  - Editing principles and exercises

### When to Load References

Load `references/formatting.md` when:
- Creating or converting a Word document
- Applying template styles or pandoc conversion

Load `references/volokh-distilled.md` when:
- Encountering specific evidence evaluation questions
- Needing detailed survey methodology guidance
- Working on substantial manuscript revision
- Checking specific word choice or usage questions

## Integration

**Required skills for document generation:**
- `/docx` - Load BEFORE creating any Word document
- `/bluebook` - Load when formatting legal citations

After completing any legal writing task, invoke `/ai-anti-patterns` to check for AI writing indicators. The `/writing` skill covers general prose principles (active voice, omit needless words) that complement this skill.

Related Skills

writing

6
from edwinhu/workflows

This skill should be used when the user asks to 'write a paper', 'start a writing project', 'draft an article', 'write about', 'brainstorm writing topics', 'gather sources for a paper', 'what should I write about', or needs the writing workflow entry point for any writing task.

writing-validate

6
from edwinhu/workflows

Validate draft sections cover all PRECIS claims before review.

writing-setup

6
from edwinhu/workflows

Internal skill for creating PRECIS.md, OUTLINE.md, and ACTIVE_WORKFLOW.md. Called after brainstorm sources are gathered.

writing-revise

6
from edwinhu/workflows

This skill should be used when the user asks to 'revise writing', 'fix review issues', 'polish draft', 'apply review feedback', 'complete writing workflow', or after /writing-review produces REVIEW.md with issues to fix.

writing-review

6
from edwinhu/workflows

Internal skill for hierarchical document review. Called by writing-validate after claim validation passes.

writing-precis-reviewer

6
from edwinhu/workflows

Internal skill used by writing-setup at exit gate. Dispatches a reviewer subagent to verify PRECIS.md quality before outlining. NOT user-facing.

writing-outline

6
from edwinhu/workflows

Internal skill for creating detailed section outlines. Called by /writing workflow after PRECIS and master OUTLINE are complete.

writing-outline-reviewer

6
from edwinhu/workflows

Internal skill used by writing-outline at exit gate. Dispatches a reviewer subagent to verify OUTLINE.md quality before drafting. NOT user-facing.

writing-lit-review

6
from edwinhu/workflows

Internal skill for literature review and source materialization. Called after brainstorm, before setup. NOT user-facing.

writing-handoff

6
from edwinhu/workflows

Create structured handoff document for writing workflow session pause/resume.

writing-general

6
from edwinhu/workflows

Internal skill for Strunk & White writing rules. Loaded by /writing for quick edits or as base layer for domain skills.

writing-econ

6
from edwinhu/workflows

Internal skill for economics and finance writing. Loaded by /writing when style=econ. Based on McCloskey's "Economical Writing".