agentsclimarketplace

Ylj thesis and contribution

Skill brycewang-stanford/Awesome-Journal-Skills/Yale-Law-Journal-Skills/skills/ylj-thesis-and-contribution

Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的 Claude Code/Codex 期刊技能包,从选题、识别策略到表格规范与审稿回复全流程,助你快速发论文。

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-thesis-and-contribution

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use when sharpening the central legal-scholarly claim and contribution for a The Yale Law Journal (YLJ) piece. It forces a falsifiable, generalist thesis and names the contribution type; it does not search prior literature (use ylj-preemption-check) or build the argument (use ylj-argument-structure).

SKILL.md

7.9 KB, as published. Nobody here has run it

Thesis & Contribution (ylj-thesis-and-contribution)

A YLJ piece lives or dies on a single, sharp claim that a generalist reader can restate. Student editors (and faculty advisors they consult) reject pieces whose "thesis" is really a topic or a survey. This skill nails the claim and labels the contribution; it does not yet prove novelty (ylj-preemption-check) or sequence the argument (ylj-argument-structure).

When to trigger

  • You can name the area but cannot state the claim in one sentence
  • A reader asks "so what's the argument?" and you give a paragraph, not a sentence
  • The introduction promises several things and the reader cannot tell which is the point
  • You are unsure whether the contribution is descriptive, doctrinal, theoretical, or normative

The one-sentence thesis test

Write: "This [Article/Essay] argues that ____, and therefore ____." It must be:

  • Contestable — a smart reader could disagree; if no one would dispute it, it is not a thesis.
  • Generalist — legible to a reader outside the subfield (see ylj-topic-selection).
  • Load-bearing — every Part of the piece exists to establish or apply this claim.
  • Yours — it is the move you make, not a restatement of existing scholarship.

If you need "and" three times, you have three theses; pick the one the piece is actually about.

Name the contribution (most YLJ pieces blend two)

TypeWhat it addsTell
DescriptiveA pattern no one has named (a doctrine is incoherent, a practice is widespread)"Courts/agencies are actually doing X."
DoctrinalA better reading of authority (statute, precedent, constitutional text)"The correct rule is X, not Y."
TheoreticalA framework that reorganizes how we understand a field"X is best understood as Y."
NormativeA reform: what the law should be and who should change it"Congress/the Court should do X."
CriticalAn immanent critique exposing a hidden assumption"The standard account rests on an untenable Z."

State which type(s) you are making — and to whom the normative payoff is addressed (court, Congress, agency, bar), because YLJ readers include all of them.

Build the YLJ contribution contract

Do not leave the contribution as a label. Convert it into a four-part contract that a student editor can defend to the Articles & Essays Committee:

Contract fieldRequired answerFailure mode
ClaimWhat is the one legal proposition the piece asks the reader to accept?A topic, survey, or issue-spotter memo
InterventionWhat legal understanding changes if the claim is right?A restatement of an existing debate
Authority baseWhich doctrine, statute, institutional practice, archive, empirical record, or theory bears the weight?A thesis that floats above sources
PayoffWho should reason or act differently: court, legislature, agency, litigants, scholars, or legal educators?A "so what" paragraph with no actor

The contract must be short enough to fit in the first-page roadmap, but strong enough to survive preemption review. If one field is missing, route back before polishing prose.

Student-editor screen

YLJ's first screen is by excellent generalist student editors, not specialists already committed to your subfield. Before moving to ylj-preemption-check, test whether the thesis can pass a two-minute committee pitch:

  1. Hook: "The legal system currently assumes X, but this piece shows Y."
  2. Why now: a doctrinal split, institutional change, regulatory moment, social practice, or scholarly blind spot makes the claim timely.
  3. Why YLJ: the claim travels beyond a narrow specialty and changes how a general legal audience understands the field.
  4. Risk: the strongest objection is named honestly, not hidden until Part III.

A thesis that only works after ten minutes of background is probably too narrow, too jargon-heavy, or still a literature review. Use ylj-writing-style later, but fix the claim here first.

Preemption handoff

This skill does not perform the literature search, but it must create a search-ready hypothesis for ylj-preemption-check. Output the following before leaving:

  • Search terms: the doctrine, statutory phrase, institutional label, and conceptual term that would surface near-preempting work.
  • Closest likely rivals: at least three article/note/work-in-progress categories that might already make the move.
  • Distinctive move: the exact sentence explaining why your thesis is not merely an application, update, or footnote to those rivals.
  • Fallback thesis: a narrower but still interesting version if the broad claim is preempted.

Do not claim novelty here. The right output is "novelty hypothesis ready to test," not "no one has done this."

Stress-test the contribution

  • The "we already knew that" test — if a knowledgeable reader says it, the descriptive layer is thin; deepen or drop it.
  • The "so what" test — articulate the consequence if you are right; a claim with no stakes is not YLJ-worthy.
  • The "compared to what" test — name the prevailing view your claim displaces (this previews ylj-preemption-check).
  • The "committee pitch" test — a generalist student editor can explain the claim, why now, and why YLJ without reading your whole draft.
  • The "authority weight" test — the claimed intervention rests on sources the piece can actually prove, not on a clever abstract frame.

Checklist

  • Thesis fits the one-sentence template and is contestable
  • A generalist reader can restate it without your jargon
  • Contribution type(s) named; normative addressee identified
  • The prevailing view the claim displaces is named
  • Every planned Part maps to establishing or applying the claim
  • Contribution contract completed: claim, intervention, authority base, payoff
  • Committee-pitch version names hook, timeliness, YLJ fit, and strongest objection
  • Preemption handoff ready: search terms, likely rivals, distinctive move, fallback thesis

Anti-patterns

  • A "thesis" that is a topic ("This Article examines X") rather than a claim
  • Three theses stitched with "and" — the piece reads as unfocused to a student editor
  • A purely descriptive contribution dressed as theory (no framework actually emerges)
  • A normative payoff with no named decision-maker who could act on it
  • Overclaiming novelty before running ylj-preemption-check
  • A generalist pitch that depends on prestige cues, topical buzz, or urgency without a legal intervention
  • A "novelty" claim that has no search terms or likely rivals for the preemption check

Output format

【Thesis】"This [Article/Essay] argues that ___, and therefore ___."
【Contribution】descriptive / doctrinal / theoretical / normative / critical (+ blend)
【Contract】claim / intervention / authority base / payoff
【Committee pitch】hook + why now + why YLJ + strongest objection
【Displaces】the prevailing view this claim challenges
【Addressee】who should act on the normative payoff
【Preemption handoff】search terms + closest likely rivals + distinctive move + fallback thesis
【Next】ylj-preemption-check to confirm the claim is genuinely new

Supplementary resources

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.