Agent skill · Code Review & Quality

asr-theory-building

Use when building the theoretical argument of an American Sociological Review (ASR) manuscript into a portable contribution — for quantitative, demographic, comparative-historical, ethnographic, network, or computational work. ASR rewards a mechanism that travels over a setting-bound finding. Structures the argument; it does not run analyses.

brycew6m878★ · +32/wk · 1 repos on radarProfile →
claude-codeMIT
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill asr-theory-building --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 6 KB
Bundled scripts: none
Path: American-Sociological-Review-Skills/skills/asr-theory-building/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 909 · +31 this week
Language: Stata
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Theory & Argument Building (asr-theory-building) At ASR a finding becomes a contribution when it is attached to a **theoretical argument other sociologists can use.** This skill turns evidence into theory: explicit mechanisms, scope conditions, and concepts, in the idiom appropriate to your method. ## When to trigger - The empirics are strong but the "so what / why" is thin - A reviewer said the paper is "atheoretical," "merely descriptive," or "case-bound" - You need to state the mechanism, the concepts, and where the argument holds - Reconciling rich case material (ethnography/history) with a general claim ## Build the argument (by mode of work) ### Quantitative / demographic 1. **Concept** — define key constructs (e.g., the form of inequality, mobility, the social process) and distinguish them from neighbors. 2. **Mechanism** — the social process generating the pattern: who, why, under what structural conditions. 3. **Observable implications** — what we should and should not see if the mechanism operates; these become tests in `asr-research-design`. 4. **Scope conditions** — populations, periods, contexts where the argument holds. ### Comparative-historical - Build the argumen

What's inside
Steps it walks through
  1. When to trigger
  2. Build the argument (by mode of work)
  3. Quantitative / demographic
  4. Comparative-historical
  5. Ethnographic / interview
  6. Network / computational
  7. The "portability" test (ASR-specific)
  8. What "theoretical contribution" means to an ASR referee
  9. Worked micro-example (illustrative)
  10. Referee pushback → ASR-specific fix
  11. Calibration anchors
  12. Anti-patterns
  13. Output format
  14. Supplementary resources
More from Awesome-Journal-Skills
All skills →
About this skill
What does the asr-theory-building skill do?

Use when building the theoretical argument of an American Sociological Review (ASR) manuscript into a portable contribution — for quantitative, demographic, comparative-historical, ethnographic, network, or computational work. ASR rewards a mechanism that travels over a setting-bound finding. Structures the argument; it does not run analyses.

How do I install it?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill asr-theory-building --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From brycewang-stanford/Awesome-Journal-Skills, a repository with 909 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going