agentsclimarketplace

Ylj revision and editing

Skill brycewang-stanford/Awesome-Journal-Skills/Yale-Law-Journal-Skills/skills/ylj-revision-and-editing

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-revision-and-editing

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 working through The Yale Law Journal (YLJ) post-acceptance editing cycle and answering author queries, or when preparing a shorter YLJ Forum piece. It covers the intensive student edit + the online companion path; it does not run the final cite verification (ylj-footnotes-and-cite-check).

SKILL.md

5.2 KB, as published. Nobody here has run it

Revision & Editing (ylj-revision-and-editing)

Acceptance at YLJ begins an intensive, multi-round student edit. Editors will substantively engage the argument, restructure for clarity, query every doubtful assertion, and (via source-pull) verify every footnote. This skill manages that cycle and the YLJ Forum online-companion path. The line-by-line cite verification it triggers is ylj-footnotes-and-cite-check.

When to trigger

  • A piece was accepted and the editing cycle is starting
  • You are answering a batch of author queries from student editors
  • A substantive edit threatens your argument and you must push back constructively
  • You are preparing a Forum piece (shorter, faster, often a response to a print article)

The print edit cycle (what to expect)

RoundEditors doYou do
Substantive / structuralTest the argument; flag gaps, overclaims, unaddressed objectionsTighten the claim; add the missing step; defend or concede
Source-pullVerify every footnote: existence, Bluebook form, supportResolve queries; supply pinpoints; fix unsupported cites
Line editSentence-level clarity, consistency, house stylePreserve meaning; accept clarity edits; flag any that change the law
Technical / proofBluebook conformity, cross-references, typesettingFinal read; confirm nothing shifted in your argument

Working the cycle well

  • Engage, don't resist. Student editors improve pieces; treat substantive queries as free peer review. Concede where they're right; that builds trust for the edits that matter.
  • Protect the law. A clarity edit that subtly misstates a holding is the one place to push back firmly — flag it, explain the doctrinal stakes, propose alternative wording.
  • Answer queries precisely. For each query give the pinpoint, the quotation, or the correction — not "trust me." Vague answers generate more queries.
  • Keep a clean change log. Track what each round changed so the argument stays coherent end-to-end.

Query-response ledger

Treat every editor query as a small validation gate. For each query, record:

FieldDecision
Query typeDoctrine / source support / Bluebook form / structure / prose / scope
Risk levelHigh if the edit changes the legal rule, holding, remedy, or claim scope
Response evidencePinpoint, quote, corrected sentence, or concession
ActionAccept / accept with revised wording / push back with alternative / revise claim
Follow-upCite-check, cross-reference update, or Part-map update needed

The default is to accept clarity edits. Push back only when the edit changes the law, removes a necessary limitation, or breaks the claim's logic. When pushing back, propose replacement language in the same message so the editor has a clean path forward.

The YLJ Forum path

  • The Forum is YLJ's online companion (the Journal was the first leading law review to launch one; relaunched as the Forum in 2014) for short, timely pieces and responses to print articles (检索于 2026-06;以官网为准).
  • Encouraged length < 10,000 words incl. footnotes (~20 pages); turnaround is faster than print.
  • A Forum response still needs a real claim, full Bluebook footnotes, and source-pull — "online" does not mean "informal."
  • If your idea is timely (a new opinion, a live debate) or directly answers a recent YLJ article, consider the Forum over print.

Checklist

  • Each round's edits absorbed without breaking the argument's spine
  • Every author query answered with a pinpoint/quote/correction, not assertion
  • Any clarity edit that misstates the law flagged and corrected
  • Change log kept; argument coherent end-to-end
  • (Forum) claim + full apparatus present despite the faster cycle

Anti-patterns

  • Treating substantive editor queries as adversarial rather than as free review
  • Accepting a smooth line edit that quietly misdescribes a holding
  • Answering source-pull queries with "it's in there somewhere" instead of a pinpoint
  • Assuming a Forum piece can skip Bluebook rigor because it's online
  • Letting accumulated edits drift the argument off its original claim

Output format

【Stage】substantive / source-pull / line edit / proof / Forum
【Queries open】count + the hard ones
【Query ledger】high-risk edits classified and answered with evidence? Y/N
【Law-integrity risk】any edit that misstates a holding? flagged? Y/N
【Argument coherence】spine intact after edits? Y/N
【Next】ylj-footnotes-and-cite-check for the final cite verification

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.