A skill your agent uses when revising prose to match The Yale Law Journal (YLJ) house style — clear, generalist-legible legal writing with a disciplined footnote-to-text balance.

MITAuto-check passedWriting & Content

Install Ylj Writing Style

skills CLI
$ npx skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-writing-style -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install brycewang-stanford/Awesome-Journal-Skills ylj-writing-style --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/brycewang-stanford/Awesome-Journal-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Yale-Law-Journal-Skills/skills/ylj-writing-style .claude/skills/ylj-writing-style && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ylj-writing-style
GitHub stars
1.2k
Token cost
~1.1k tokens
SKILL.md length
527 words
Files
1
Skills in repo
2,387
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when revising prose to match The Yale Law Journal (YLJ) house style — clear, generalist-legible legal writing with a disciplined footnote-to-text balance.

  • Works in 5 steps: Text-first. The argument must be… → Generalist legibility. Define terms of… → Plain, confident voice. Prefer the… → …
  • Revising prose to match The Yale Law Journal (YLJ) house style — clear
  • SKILL.md covers When to trigger, House-style priorities, Sentence and paragraph craft and The footnote-to-text balance…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ylj Writing Style is an agent skill from brycewang-stanford/Awesome-Journal-Skills. 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).

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Brand voice and tone, Plain language and style rules and Citation management. The repository describes itself as: Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的… The licence is MIT.

When your agent uses it

  • Revising prose to match The Yale Law Journal (YLJ) house style — clear
  • Generalist-legible legal writing with a disciplined footnote-to-text balance

Example prompts

  • “/ylj-writing-style”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Text-first. The argument must be followable from the text alone; footnotes support and elaborate
  2. Generalist legibility. Define terms of art on first use; don't assume the reader lives in your
  3. Plain, confident voice. Prefer the active voice and concrete subjects. State the claim; don't
  4. Topic sentences that argue. Each paragraph opens with the claim it proves, not the subject it
  5. Footnote discipline. Substance belongs in text; footnotes hold cites, qualifications, and

What it can do on your machine

Read from SKILL.md and the folder at commit 932eb23. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ylj Writing Style loads about 1.1k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 527 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from brycewang-stanford/Awesome-Journal-Skills at commit 932eb23, republished under its MIT licence (© brycewang-stanford). 527 words, ~1,123 tokens.

Download SKILL.mdSave it as .claude/skills/ylj-writing-style/SKILL.md (or your agent's skills folder).
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.
Show full SKILL.md (211 more words)Show less

The footnote-to-text balance (a YLJ pressure point)

SymptomFix
40% of the page is footnotePromote argument to text; cut footnote essays to cites + key qualifier
The reader must read footnotes to follow the argumentMove the load-bearing reasoning up into the text
A footnote runs longer than its paragraphSplit: keep the cite; relocate substance or delete
Stacked see also with no parentheticalsTrim; 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

© brycewang-stanford, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Yale-Law-Journal-Skills/skills/ylj-writing-style of brycewang-stanford/Awesome-Journal-Skills.

Open the folder on GitHubat commit 932eb23

Compare with similar skills

Ylj Writing Style next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ylj Writing Style compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ylj Writing Style this skillbrycewang-stanford/Awesome-Journal-Skills1.2k—~1.1kAutomated safety check: PassMIT
UX Writingcontent-designer/ux-writing-skill2241 repos~3.8kAutomated safety check: PassMIT
Technical Writing Workflowtokenbender/agent-guides367—~1.3kAutomated safety check: PassApache-2.0
Blog PersonaAgriciDaniel/claude-blog2.3k1 repos~2.3kAutomated safety check: PassMIT
Repo System Maptamdogood/builder-essential-skills222—~3kAutomated safety check: NotesMIT
Writing Style ReviewArmDeveloperEcosystem/arm-learning-paths154—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • UX Writing

    content-designer/ux-writing-skill

    Applies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance.

    224 GitHub starsUsed in 1 repo~3.8k tokens
    Writing & ContentAuto-check passed
  • Technical Writing Workflow

    tokenbender/agent-guides

    A skill your agent uses for planning, researching, drafting, revising, or auditing technical write-ups, textbooks, papers, reports, READMEs, research notes, PR narratives, and public technical prose.

    367 GitHub stars~1.3k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Blog Persona

    AgriciDaniel/claude-blog

    Create and manage writing personas with NNGroup 4-dimension tone framework (Funny-Serious, Formal-Casual, Respectful-Irreverent, Enthusiastic-Matter-of-fact).

    2.3k GitHub starsUsed in 1 repo~2.3k tokens
    Writing & ContentAuto-check passed
  • Repo System Map

    tamdogood/builder-essential-skills

    Analyze a software repository at the latest remote main commit and turn its implemented architecture into a citation-backed interactive isometric system map with a legend, selectable infrastructure…

    222 GitHub stars~3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: notes
  • Writing Style Review

    ArmDeveloperEcosystem/arm-learning-paths

    Review and improve writing style, voice, tone, readability, inclusive language, Arm terminology, heading style, word choice, and AI-sounding prose in Arm Learning Paths and install guides.

    154 GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Readability Guidance

    testdouble/han

    Surfaces Han's shared Human-Readable Output Standard — the readability rule and the writing-voice profile — into the calling skill's own context, so the caller drafts in voice and runs its…

    281 GitHub stars~1.6k tokensUpdated 10 days ago
    Writing & ContentAuto-check passed

More from brycewang-stanford/Awesome-Journal-Skills

All 2,387 skills in this repo
  • Aaag Data Analysis

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running and reporting the analysis for an Annals of the American Association of Geographers manuscript — spatial statistics and modeling, remote-sensing accuracy, or…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Literature Positioning

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when positioning an Annals of the American Association of Geographers manuscript in the literature — engaging geographic scholarship across the relevant area and the…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Rebuttal

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when responding to an Annals of the American Association of Geographers decision letter (major/minor revision) — building a point-by-point response to the subject editor and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Research Design

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when defending the research design of an Annals of the American Association of Geographers manuscript — spatial/quantitative analysis and GIScience, remote-sensing and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Review Process

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when you need to understand how the Annals of the American Association of Geographers evaluates a manuscript — double-anonymous review routed through a subject editor by…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Submission

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running the final pre-submission preflight for the Annals of the American Association of Geographers via ScholarOne Manuscripts — area/article-type selection…

    1.2k GitHub stars~1.6k tokensUpdated 14 days ago
    Auto-check passed

Questions about Ylj Writing Style

What does Ylj Writing Style do?

A skill your agent uses when revising prose to match The Yale Law Journal (YLJ) house style — clear, generalist-legible legal writing with a disciplined footnote-to-text balance. Ylj Writing Style is an agent skill from brycewang-stanford/Awesome-Journal-Skills. 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.

When should I use Ylj Writing Style?

Ylj Writing Style fits situations like: revising prose to match The Yale Law Journal (YLJ) house style — clear; generalist-legible legal writing with a disciplined footnote-to-text balance.

How do I install Ylj Writing Style in Claude Code?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-writing-style -a claude-code`. Or copy the skill folder (Yale-Law-Journal-Skills/skills/ylj-writing-style in brycewang-stanford/Awesome-Journal-Skills) into .claude/skills/ylj-writing-style in your project. Claude Code loads it when a task matches its description.

How do I install Ylj Writing Style in Codex?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-writing-style -a codex`. Or copy the skill folder (Yale-Law-Journal-Skills/skills/ylj-writing-style in brycewang-stanford/Awesome-Journal-Skills) into .agents/skills/ylj-writing-style in your project. Codex loads it when a task matches its description.

Can I use Ylj Writing Style in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill ylj-writing-style -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ylj-writing-style, .gemini/skills/ylj-writing-style, .github/skills/ylj-writing-style and .opencode/skills/ylj-writing-style in your project.

What does Ylj Writing Style need to run?

SKILL.md names no scripts, command-line tools or credentials: Ylj Writing Style is instructions for the agent only.

Does Ylj Writing Style access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ylj Writing Style safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ylj Writing Style use?

Ylj Writing Style is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ylj Writing Style use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ylj Writing Style?

Skills that share tags, products or a category with Ylj Writing Style: UX Writing (content-designer/ux-writing-skill, 224 stars), Technical Writing Workflow (tokenbender/agent-guides, 367 stars), Blog Persona (AgriciDaniel/claude-blog, 2.3k stars) and Repo System Map (tamdogood/builder-essential-skills, 222 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ylj Writing Style?

brycewang-stanford (a GitHub user) maintains it in brycewang-stanford/Awesome-Journal-Skills, which has 1,231 GitHub stars. The repository holds 2,387 skills in this directory. The repository was last updated on September 27, 2026.

Source: brycewang-stanford/Awesome-Journal-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.