Academic style
Skill mronkko/claude-academic-research/skills/academic-style
Use when drafting or editing academic prose — topic sentences, paragraph structure, APA-style citations, active voice, tense, hedging conventions, term definitions. Fires eagerly on any .qmd / .Rmd / .md / .tex file in an academic-research project. Do NOT use for the revision workflow — use `manuscript-revision` + `/critic-loop`. Do NOT use for factual or citation accuracy — use `grounded-citations` / `empirical-integrity` / `fact-check`.From its SKILL.md
npx -y skills add mronkko/claude-academic-research --skill academic-styleAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.0 KB, as published. Nobody here has run it
Academic style
No pre-flight, no bootstrap by design. This is a doctrine skill — pure prose conventions. It does not call MCPs, does not install project scaffolds, and does not need
/setupto have run. The procedural skills (zotero-operations,systematic-review,fact-check,critic-loop) gate themselves oncheck_configured.py; this one stays out of the way.
Core rule
Academic prose follows a small set of conventions that the agent applies
during drafting, not only at revision time. These are the rules the
critic-loop argument critic checks later — but writing them in
correctly the first time reduces how much the critic loop has to
fix.
This skill governs style and conventions only. It does not govern:
- Citation sourcing (Zotero-backed, consulted, claim-supporting) →
grounded-citationsrule-book. - Quantitative claims (numbers from pipeline files) →
empirical-integrityrule-book. - When and how to revise a draft →
manuscript-revision+ thecritic-loopskill.
Citations (APA-style)
Formatting only; sourcing is governed by grounded-citations — follow
both. Format conventions:
- Inline:
[@key]produces "(Smith, 2019)". - Parenthetical with multiple:
[@key1; @key2]produces "(Jones, 2020; Smith, 2019)". - Narrative:
@key [-@key]produces "Smith (2019)" / "Smith's (2019)". - Three or more authors: render as
et al.automatically via the CSL; do not hand-type "et al.". - Cite the most specific pinpointable source. When a claim could come from a review or from the primary paper, cite the primary.
Voice and tense
- Active voice where it strengthens clarity: "We coded 1,243 papers" over "1,243 papers were coded". Passive is acceptable when the actor is unknown or unimportant.
- Methods in past tense (this study's actions): "We ran a pilot search against Scopus".
- Theory and established findings in present (ongoing truth): "Self-efficacy predicts persistence".
- Discussion is present when interpreting ("Our findings suggest") and past when describing what this study did ("We found").
Hedging calibration
Strong claims require strong evidence. Match hedging to design:
- Cross-sectional data warrants "associated with", "is correlated with", "differs across" — never "predicts", "causes", or "leads to".
- Observational longitudinal data without identification strategy warrants "is longitudinally associated with" or "precedes" — still not "causes".
- RCT / natural experiment / well-identified quasi-experiment warrants causal language.
- Don't hedge findings the field considers well-established (this signals false novelty). Don't over-claim findings that are novel.
(The critic-loop method critic flags violations at revision time —
writing to this standard up-front means the critic has less to catch.)
Structure
- Empirical papers: IMRAD (Introduction, Methods, Results, Discussion). Each section scope-checked against Introduction's stated research question.
- Review papers: synthesis over enumeration. The text must analyse across cited studies, not march through them one at a time. Long stretches of "Smith (2019) found X. Jones (2020) found Y. Kim (2021) found Z." are a red flag — replace with thematic prose that names patterns, tensions, or cumulative findings and cites multiple papers per claim.
- Topic sentences open paragraphs. Signposting at section transitions ("Having established X, we now turn to Y").
Terms and acronyms
- Define terms on first substantive use, not first mention.
- Expand acronyms on first occurrence: "better BibTeX (BBT)",
then
BBTthereafter. - Consistent terminology throughout. Don't switch between "growth aspirations", "growth intentions", and "growth motivation" for the same construct without explaining the distinction.
Red flags
- You are writing "Smith (2019) found X. Jones (2020) found Y." chains in a review paper — replace with thematic synthesis citing multiple papers per claim.
- You are hedging a finding the field considers well-established — drop the hedge.
- You are over-claiming from cross-sectional data ("predicts", "causes") — switch to associational language.
- You introduced an acronym without expanding it.
- Terminology drift between sections — same construct, different names.
- You are using passive voice where the actor matters and is known.
- You are adding an
et al.by hand instead of relying on CSL rendering from the BBT key.