arsoc-writing-style

GitHub

用于优化《社会学年度评论》(ARSoc) 综述的写作风格。确保语调权威且易读,面向非本领域社会学家;强化开篇框架与结论预告,要求摘要避免论文式表述并突出综述价值,结尾需提供具体的未来研究议程而非空泛建议。

Annual-Review-of-Sociology-Skills/skills/arsoc-writing-style/SKILL.md brycewang-stanford/Awesome-Journal-Skills

Trigger Scenarios

框架已定稿,需提升文本可读性时 目标读者为非本领域专家,需增强可访问性时 开篇被术语淹没或缺乏吸引力时 摘要像研究论文而非综述时 结尾缺乏具体研究议程时

Install

npx skills add brycewang-stanford/Awesome-Journal-Skills --skill arsoc-writing-style -g -y
More Options

Non-standard path

npx skills add https://github.com/brycewang-stanford/Awesome-Journal-Skills/tree/main/Annual-Review-of-Sociology-Skills/skills/arsoc-writing-style -g -y

Use without installing

npx skills use brycewang-stanford/Awesome-Journal-Skills@arsoc-writing-style

指定 Agent (Claude Code)

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

安装 repo 全部 skill

npx skills add brycewang-stanford/Awesome-Journal-Skills --all -g -y

预览 repo 内 skill

npx skills add brycewang-stanford/Awesome-Journal-Skills --list

SKILL.md

Frontmatter
{
    "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.

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

【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

Version History

  • 1839142 Current 2026-07-05 12:25

Same Skill Collection

AAAI-Skills/skills/aaai-artifact-evaluation/SKILL.md
AAAI-Skills/skills/aaai-author-response/SKILL.md
AAAI-Skills/skills/aaai-camera-ready/SKILL.md
AAAI-Skills/skills/aaai-experiments/SKILL.md
AAAI-Skills/skills/aaai-related-work/SKILL.md
AAAI-Skills/skills/aaai-reproducibility/SKILL.md
AAAI-Skills/skills/aaai-review-process/SKILL.md
AAAI-Skills/skills/aaai-submission/SKILL.md
AAAI-Skills/skills/aaai-supplementary/SKILL.md
AAAI-Skills/skills/aaai-topic-selection/SKILL.md
AAAI-Skills/skills/aaai-workflow/SKILL.md
AAAI-Skills/skills/aaai-writing-style/SKILL.md
AAMAS-Skills/skills/aamas-artifact-evaluation/SKILL.md
AAMAS-Skills/skills/aamas-author-response/SKILL.md
AAMAS-Skills/skills/aamas-camera-ready/SKILL.md
AAMAS-Skills/skills/aamas-experiments/SKILL.md
AAMAS-Skills/skills/aamas-related-work/SKILL.md
AAMAS-Skills/skills/aamas-reproducibility/SKILL.md
AAMAS-Skills/skills/aamas-review-process/SKILL.md
AAMAS-Skills/skills/aamas-submission/SKILL.md
AAMAS-Skills/skills/aamas-supplementary/SKILL.md
AAMAS-Skills/skills/aamas-topic-selection/SKILL.md
AAMAS-Skills/skills/aamas-workflow/SKILL.md
AAMAS-Skills/skills/aamas-writing-style/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-editor-strategy/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-evidence-standards/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-literature-synthesis/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-organizing-framework/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-proposal-framing/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-review-process/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-revision/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-submission/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-tables-figures/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-topic-selection/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-workflow/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-writing-style/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-contribution-framing/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-data-analysis/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-literature-positioning/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-methods/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-rebuttal/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-review-process/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-submission/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-tables-figures/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-theory-development/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-topic-selection/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-workflow/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-writing-style/SKILL.md
Academy-of-Management-Review-Skills/skills/amr-contribution-framing/SKILL.md
Academy-of-Management-Review-Skills/skills/amr-data-analysis/SKILL.md

Metadata

Files
0
Version
9f86f09
Hash
bad571cc
Indexed
2026-07-05 12:25

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-07-30 00:16
浙ICP备14020137号-1 $Carte des visiteurs$