Agent skill

crim-theory-building

Use when building the theoretical argument of a Criminology (ASC / Wiley) manuscript into a field-level contribution. Criminology rewards an explicit mechanism, scope conditions, and observable implications over a bare crime correlation, whether the work tests, extends, or adjudicates a criminological theory. Structures the argument; it does not run analyses.

brycew6m4,252★ · +31/wk · 3 repos on radarProfile →
claude-codeMIT
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill crim-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: Criminology-Skills/skills/crim-theory-building/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 984 · +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 (crim-theory-building) At *Criminology* a result is not a contribution until it is attached to a **mechanism the field can use elsewhere.** This skill turns crime findings into theory: explicit causal stories, scope conditions, and observable implications drawn from (or pushing against) the field's theoretical traditions. ## When to trigger - The empirics are strong but the "so what / why does crime behave this way" is thin - A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding" - You need to state mechanisms, assumptions, and scope conditions explicitly - You are extending or adjudicating between two criminological theories ## Build the argument 1. **Concept.** Define the key constructs precisely — offending vs. arrest, desistance vs. a lull, victimization vs. reporting, legitimacy vs. compliance. Distinguish each from its neighbors. 2. **Mechanism.** The causal story: who does what, why, under what incentives, controls, opportunities, or strains. Make it a *process*, not a regression coefficient. 3. **Observable implications.** What we should see if the mechanism operates — and what we should *not* see. These become the tests in `

What's inside
Steps it walks through
  1. When to trigger
  2. Build the argument
  3. Engage the theoretical tradition (the Criminology move)
  4. The "portability" test (Criminology-specific)
  5. Anti-patterns
  6. What "engaging the theory" means to an ASC reviewer (calibration grid)
  7. Worked vignette: from finding to mechanism (illustrative)
  8. Theory-side referee pushback (with the Criminology fix)
  9. Output format
  10. Supplementary resources
More from Awesome-Journal-Skills
All skills →
About this skill
What does the crim-theory-building skill do?

Use when building the theoretical argument of a Criminology (ASC / Wiley) manuscript into a field-level contribution. Criminology rewards an explicit mechanism, scope conditions, and observable implications over a bare crime correlation, whether the work tests, extends, or adjudicates a criminological theory. Structures the argument; it does not run analyses.

How do I install it?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill crim-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 984 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