A skill your agent uses when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong…

MITAuto-check passedWriting & Content

Install Arsoc Writing Style

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

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

GitHub CLI
$ gh skill install brycewang-stanford/Awesome-Journal-Skills arsoc-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/Annual-Review-of-Sociology-Skills/skills/arsoc-writing-style .claude/skills/arsoc-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
arsoc-writing-style
GitHub stars
1.2k
Token cost
~1.5k tokens
SKILL.md length
738 words
Files
1
Skills in repo
2,387
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong…

  • Works in 4 steps: Authoritative. Confident judgments about… → Accessible across subfields. Theoretical… → Signposted. A substantial review needs a… → …
  • Revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative
  • SKILL.md covers When to trigger, The ARSoc voice: authoritative…, The review opening arc and The forward-looking close, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Arsoc Writing Style is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong opening and a forward-looking research-agenda close, and a survey-style abstract. Polishes prose and structure; it does not design the framework (arsoc-organizing-framework) or audit balance (arsoc-comprehensiveness-and-balance).

Its SKILL.md is about 1.5k 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. 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 an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative
  • Accessible to sociologists outside the subfield
  • With a strong opening and a forward-looking research-agenda close
  • A survey-style abstract

Example prompts

  • “/arsoc-writing-style”

Workflow steps

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

  1. Authoritative. Confident judgments about what is known, what is contested, and how good the evidence is. The reader wants your appraisal…
  2. Accessible across subfields. Theoretical machinery and subfield jargon are explained intuition-first; a concept is motivated by the…
  3. Signposted. A substantial review needs a map: section architecture that mirrors the spine, plus periodic "where we are / where we go next"…
  4. Synthesis prose, not summary prose. Sentences make studies talk to each other ("Whereas the network account emphasizes X, ethnographic…

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

Arsoc Writing Style loads about 1.5k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 738 words of instructions outside code blocks.

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

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). 738 words, ~1,548 tokens.

Download SKILL.mdSave it as .claude/skills/arsoc-writing-style/SKILL.md (or your agent's skills folder).
name
arsoc-writing-style
description
Use when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong opening and a forward-looking research-agenda close, and a survey-style abstract. Polishes prose and structure; it does not design the framework (arsoc-organizing-framework) or audit balance (arsoc-comprehensiveness-and-balance).

ARSoc Writing Style — the Review Voice (arsoc-writing-style)

When to trigger

  • The framework and coverage are settled and it is time to make the review read well
  • A sociologist from an adjacent subfield would get lost or bored in the current draft
  • The opening buries the subfield's importance under jargon or throat-clearing
  • The abstract reads like a paper abstract ("we find…") rather than a review abstract
  • The close trails off into "more research is needed" instead of a concrete agenda

The ARSoc voice: authoritative + accessible + forward-looking

An ARSoc review is read by sociologists outside the subfield — smart, but not specialists here. The voice is a trusted, fair expert teaching the area to a colleague from another part of the discipline. Four qualities define it:

  1. Authoritative. Confident judgments about what is known, what is contested, and how good the evidence is. The reader wants your appraisal, not neutrality-as-evasion — but authority is earned by comprehensiveness and balance, never asserted.
  2. Accessible across subfields. Theoretical machinery and subfield jargon are explained intuition-first; a concept is motivated by the question it answers before any formalism. Because the defining reader is the outsider, a review only the subfield can follow has missed ARSoc's mandate — sharper here than at a specialist journal.
  3. Signposted. A substantial review needs a map: section architecture that mirrors the spine, plus periodic "where we are / where we go next" cues, so a reader never loses the thread.
  4. Synthesis prose, not summary prose. Sentences make studies talk to each other ("Whereas the network account emphasizes X, ethnographic work suggests Y"), rather than marching study-by-study.

The review opening arc

An ARSoc introduction differs from a research-paper intro:

frame the subfield (what it studies, why it matters to sociologists broadly) → why a synthesis is needed now (new evidence / method turn / public-policy salience) → the organizing question and the spine (the map the reader will be given) → what the review concludes and where the field should go (the payoff, stated up front) → roadmap (brief).

State the bottom line early. A review that withholds its conclusions to the end wastes the cross-subfield reader's time and reads as indecisive.

The forward-looking close

ARSoc prizes the future-agenda ending more than most outlets: the empty/thin cells of the framework become a concrete research agenda — what we do not yet know, what evidence or data would resolve it, which methods or theoretical moves are ripe. An ARSoc review that ends with "more research is needed" has wasted its most valuable section; name the specific open questions instead.

Show full SKILL.md (320 more words)Show less

The abstract

A review abstract describes what the review does for the reader — the subfield, why a synthesis now, the organizing idea, the headline state-of-knowledge takeaway, and the forward agenda — not a single empirical finding. Avoid "we estimate / we find a coefficient of…"; that is a primary-paper abstract. Confirm length/format limits on the Annual Reviews author pages (检索于 2026-06;以官网为准).

House style notes

Annual Reviews uses its own format, including a name/numbered reference style distinct from ASA author-date (检索于 2026-06;以官网为准); the production editor applies house style at acceptance, so the delivered draft need not pre-conform, but the reference data must be complete and accurate. Keep prose crisp: length is a privilege, and every section must earn its pages by advancing the argument about the subfield. Mind that sociology is attentive to language about race, gender, and groups — write with current, precise terminology.

Checklist

  • Opening follows the arc: frame subfield → why now → question + spine → conclusions + agenda → roadmap
  • Bottom-line state of knowledge stated early, not withheld to the end
  • Theoretical material and jargon introduced intuition-first; defined or avoided
  • Section architecture mirrors the spine; periodic signposting present
  • Prose synthesizes (studies in dialogue), not summarizes (study-by-study)
  • Author's appraisals are explicit and labelled as the author's read where contested
  • The close names a concrete future research agenda, not "more research is needed"
  • Abstract describes the review's contribution to the reader, not a single finding
  • A sociologist from an adjacent subfield could follow start to finish

Anti-patterns

  • The annotated-bibliography drone: "Smith (2010) finds… Jones (2012) finds…" with no connective argument
  • Opening with subfield jargon or theory machinery before the question and stakes
  • Withholding the review's conclusions until the final section
  • Jargon-first exposition that locks out the cross-subfield reader (ARSoc's defining audience)
  • A primary-paper abstract ("we find an effect of 0.3 SD") on a review
  • A limp "more research is needed" ending instead of a specific research agenda
  • Neutrality-as-evasion: refusing to appraise because appraising feels risky

Output format

text
【Opening arc】frame → why-now → question+spine → conclusions+agenda → roadmap? Y/N
【Bottom line early】state of knowledge stated up front? Y/N
【Accessibility】intuition-first; jargon controlled; adjacent sociologist can follow? Y/N
【Signposting】architecture mirrors spine; periodic cues? Y/N
【Synthesis prose】studies in dialogue, not listed? Y/N
【Forward agenda】close names concrete open questions? Y/N
【Abstract】review-style (contribution to reader), not a single finding? Y/N
【Next step】→ arsoc-transparency-and-reproducibility (coverage account) → arsoc-editor-strategy

© 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 Annual-Review-of-Sociology-Skills/skills/arsoc-writing-style of brycewang-stanford/Awesome-Journal-Skills.

Open the folder on GitHubat commit 932eb23

Compare with similar skills

Arsoc 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.

Arsoc Writing Style compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arsoc Writing Style this skillbrycewang-stanford/Awesome-Journal-Skills1.2k—~1.5kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
BrandOhh-889/skyroc79513 repos~733Automated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k1 repos~2.9kAutomated safety check: PassMIT
Writing Guidelinesvercel-labs/agent-skills32k7 repos~309Automated safety check: PassNone
Unslop AI Writing Cleanuptheclaymethod/unslop518—~1.7kAutomated safety check: PassMIT

Similar skills

  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • Brand

    Ohh-889/skyroc

    Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

    795 GitHub starsUsed in 13 repos~733 tokens
    Writing & ContentAuto-check passed
  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 1 repo~2.9k tokens
    Writing & ContentAuto-check passed
  • Writing Guidelines

    vercel-labs/agent-skills

    Official

    Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills.

    32k GitHub starsUsed in 7 repos~309 tokens
    Writing & ContentAuto-check passed
  • Unslop AI Writing Cleanup

    theclaymethod/unslop

    Removes AI writing tells from prose through an audit-first flow, routing to a two-pass rewrite, a report-only cleanup, voice teaching or mimicry depending on the sub-command used.

    518 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • 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

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 Arsoc Writing Style

What does Arsoc Writing Style do?

A skill your agent uses when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong…. Arsoc Writing Style is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative, accessible to sociologists outside the subfield, signposted, with a strong opening and a forward-looking research-agenda close, and a survey-style abstract.

When should I use Arsoc Writing Style?

Arsoc Writing Style fits situations like: revising an Annual Review of Sociology (ARSoc) review for the ARSoc voice — authoritative; accessible to sociologists outside the subfield; with a strong opening and a forward-looking research-agenda close; A survey-style abstract.

How do I install Arsoc Writing Style in Claude Code?

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

How do I install Arsoc Writing Style in Codex?

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

Can I use Arsoc 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 arsoc-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/arsoc-writing-style, .gemini/skills/arsoc-writing-style, .github/skills/arsoc-writing-style and .opencode/skills/arsoc-writing-style in your project.

What does Arsoc Writing Style need to run?

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

Does Arsoc 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 Arsoc 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 Arsoc Writing Style use?

Arsoc 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 Arsoc Writing Style use?

About 1.5k tokens (SKILL.md is roughly 6.2k 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 Arsoc Writing Style?

Skills that share tags, products or a category with Arsoc Writing Style: Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), Brand (Ohh-889/skyroc, 795 stars), Khazix WeChat Article Writer (KKKKhazix/khazix-skills, 21k stars) and Writing Guidelines (vercel-labs/agent-skills, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arsoc 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.