Use when tightening prose and removing spin from a JAMA manuscript to match the journal's clinical house style and the AMA Manual of Style. Polishes language and framing; it does NOT change the analysis or the reported numbers.
Scanned 6/5/2026
Install to Claude Code
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill jama-writing-style --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Jama Writing Style?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/brycewang-stanford-jama-writing-style)More formats (shields.io, HTML) on the badges page.
---
name: jama-writing-style
description: Use when tightening prose and removing spin from a JAMA manuscript to match the journal's clinical house style and the AMA Manual of Style. Polishes language and framing; it does NOT change the analysis or the reported numbers.
---
# Writing Style & House Style (jama-writing-style)
## When to trigger
- Prose is verbose, hedged, or jargon-heavy for a general clinician audience
- The Conclusions overstate the data ("spin")
- Observational findings are written with causal verbs
- Late-stage polish before submission, after design/stats/exhibits are settled
## House-style essentials (AMA Manual of Style)
- JAMA follows the **AMA Manual of Style**. Conform numbers, units, abbreviations, statistical notation, and reference format to it — verify current rules in the manual / author instructions.
- **SI units** with conventional units as needed; define every abbreviation at first use; avoid undefined acronyms.
- **Person-first, non-stigmatizing language** (e.g., "patients with diabetes," not "diabetics"); report and justify race/ethnicity and sex/gender per current JAMA guidance.
- Exact p-values (P = .04, not P < .05); leading zeros omitted for p-values per AMA convention; estimates always paired with 95% CIs.
- Active voice and short sentences where possible; the IMRaD structure (Introduction, Methods, Results, Discussion).
## Avoiding "spin"
Spin is language that makes results sound better than the data support. JAMA reviewers and editors actively police it.
| Spin pattern | Fix |
|---------------------------------------------------------|-----------------------------------------------------------|
| Null primary outcome, upbeat conclusion | State the primary result plainly; do not pivot to secondaries |
| Secondary/post hoc outcome framed as main finding | Foreground the pre-specified primary outcome |
| "Trend toward significance" for a non-significant result | Report the estimate + CI; avoid the phrase |
| Causal verbs ("reduced," "caused") for observational data | Use associational verbs ("was associated with") |
| "Safe and well tolerated" beyond what harms data show | Report harms quantitatively; calibrate the claim |
| Over-generalizing beyond the studied population | Bound the conclusion to the sample/setting |
## Discussion structure JAMA expects
1. Brief statement of the principal findings (tied to the primary outcome).
2. Comparison with prior evidence; how this study adds.
3. Possible mechanisms / explanations (without overreach).
4. **Limitations** — candid, specific (bias, generalizability, power, missing data).
5. Conclusions and clinical relevance, proportionate to the evidence.
## Checklist
- [ ] Abstract, Results, and Conclusions agree numerically and in tone
- [ ] Conclusion is bounded by the primary outcome; no spin
- [ ] Observational findings use associational language
- [ ] Harms reported quantitatively before any "safe/tolerated" claim
- [ ] Abbreviations defined at first use; SI units; AMA statistical notation
- [ ] Person-first, non-stigmatizing language; race/sex reported per guidance
- [ ] A specific, candid Limitations paragraph is present
- [ ] Reference format follows AMA style (verify current rules)
## Anti-patterns
- Spin: a positive-sounding conclusion over a null primary outcome
- Causal language for an observational association
- "Trend toward significance" / "marginally significant"
- Burying limitations or making them generic ("as with all studies…")
- Jargon and undefined acronyms that exclude a general clinician reader
- Tone in the abstract that the body does not support
## Output format
```
【Spin found】none / instances: ...
【Causal-vs-associational language correct】yes / fixes: ...
【Harms calibrated】yes / no
【Limitations specific】yes / no
【AMA style conformance】numbers/units/abbrev/refs: ...
【Next skill】jama-cover-letter
```
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!