agentsclimarketplace

Psychbull theory integration

Skill brycewang-stanford/Awesome-Journal-Skills/Psychological-Bulletin-Skills/skills/psychbull-theory-integration

Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的 Claude Code/Codex 期刊技能包,从选题、识别策略到表格规范与审稿回复全流程,助你快速发论文。

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill psychbull-theory-integration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use when turning the synthesis results of a Psychological Bulletin manuscript into a genuine theoretical contribution — reconciling conflicting findings, building or refining a model, and stating scope conditions and a research agenda. Makes the synthesis matter; it does not run the analysis.

SKILL.md

5.9 KB, as published. Nobody here has run it

Theory Integration (psychbull-theory-integration)

A Psychological Bulletin paper is judged not by the size of its table but by what the synthesis means for psychology. The journal publishes evaluative and integrative reviews — the value is in interpreting an existing literature, reconciling its contradictions, and advancing or refining a theoretical account. (Note: a purely new theory with no synthesis belongs to Psychological Review; here the theory is grounded in the synthesized evidence.) This skill builds the contribution; the numbers come from the analysis skills.

When to trigger

  • The pooled effect, moderators, and bias analyses exist and you must say what they mean
  • A literature has conflicting findings you can now reconcile
  • Building or refining a theoretical model from the synthesized evidence
  • A reviewer says the review is "a competent meta-analysis but not a contribution"

From results to contribution

  1. Answer the field's open question. State what the synthesis resolves: the size of an effect, why studies disagreed, which moderator explains the pattern, whether an effect survives bias correction.
  2. Reconcile conflict with the moderators. Use the moderator/meta-regression results to explain why prior studies clashed — different populations, measures, designs, or conditions.
  3. Build or refine a model. Translate the empirical pattern into a theoretical statement: an integrative framework, boundary conditions, a mediating/moderating mechanism, or a corrected estimate.
  4. State scope conditions honestly. Where does the effect hold, and where not? Heterogeneity and the prediction interval discipline the claim.
  5. Set the agenda. What should primary researchers do next — the gaps, the under-powered cells, the untested moderators the synthesis exposes.

Calibrate claims to evidence

  • Match the strength of the theoretical claim to heterogeneity, k, and bias robustness.
  • Distinguish confirmatory (pre-specified) from exploratory patterns when theorizing.
  • Avoid over-reading a fragile or bias-sensitive effect into a strong theory.

Anti-patterns

  • A "results dump" with no interpretive or theoretical payoff
  • Theorizing past the evidence (strong claims on small k or bias-sensitive effects)
  • Ignoring heterogeneity when stating a general law
  • Presenting an exploratory moderator as if it were the confirmatory story
  • Submitting a pure new theory that should have gone to Psychological Review

The integration bar that defines a Bulletin paper

This is the calibration anchor that separates the APA's flagship review journal from a methods-only meta-analysis: a competent pooled estimate is necessary but not sufficient. The genuine theoretical advance is the threshold reviewers police.

Synthesis delivers…Methods-only meta-analysis (reject risk)Psychological Bulletin contribution
A pooled number"The effect is g = 0.34" and stopsExplains what that resolves for the field
HeterogeneityReports I² = 68% as a nuisanceUses moderators to say why studies disagreed
A modelNone — tallies effectsAdvances or refines a theoretical account
ScopeImplies the effect is universalStates boundary conditions from the PI

Worked vignette — turning numbers into theory

Illustrative numbers only. The self-affirmation synthesis yields g = 0.34 [0.24, 0.44], I² = 68%, with delivery format explaining an R²-analog of 0.22 and bias diagnostics pulling the effect toward ≈ 0.25. The integrative payoff under this skill's rules:

  • Open question resolved: self-affirmation has a small-to-moderate but real effect, smaller than the early enthusiastic literature implied once selective reporting is modeled.
  • Conflict reconciled: the disagreement tracks delivery format — facilitated, in-person formats outperform brief written prompts — not a true-versus-null split.
  • Model refined: this sharpens the timing/fit account rather than proposing a brand-new theory (which would belong to Psychological Review).
  • Scope conditions: the wide prediction interval [−0.10, 0.78] disciplines the claim — the effect can vanish in some settings, so no universal law is asserted.
  • Agenda: pre-registered trials varying delivery format, and direct tests of the underutilized cells.

Referee pushback → venue-specific fix

  • "Competent meta-analysis, but not a contribution." → Add the interpretive layer: state the field question and how the moderators resolve the conflict, not just the pooled number.
  • "You theorize past your evidence." → Down-calibrate to k, heterogeneity, and bias robustness.
  • "This is really a new theory." → If the model is not grounded in the synthesized evidence, it belongs to Psychological Review.

Output format

【Open question resolved】one sentence
【Conflict reconciled】via which moderator(s)
【Model / framework】what is advanced or refined
【Scope conditions】where it holds / breaks
【Research agenda】top gaps for primary work
【Claim calibration】matched to k / heterogeneity / bias? [Y/N]
【Next】psychbull-tables-figures

Supplementary resources

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.