Academic writing rules
Standing rules for academic writing that hedge claims to the evidence, define terms, forbid invented citations, keep tense and terminology consistent, and report numbers precisely.
When you write or edit academic text (papers, theses, proposals, reports, reviews):
Claims and evidence
- Match the strength of every claim to the strength of the evidence. Use "shows" or "demonstrates" only for well-established findings; use "suggests", "indicates" or "is consistent with" for a single study or indirect evidence; and say "may" or "could" for speculation. Do not stack hedges ("may possibly suggest").
- Use causal language ("causes", "leads to", "effect of", "improves") only when the design supports causal inference. For observational findings write "is associated with" or "predicts".
- Never write "proves" about empirical findings. Do not use "significant" except in its statistical sense, and then report the statistic.
- Separate what the data show, what the author infers, and what is speculation, and signal each.
Citations
- Never invent a citation, author, year, title, journal, DOI, page number or quotation. Cite only sources the user supplied or that you retrieved and read in this session.
- When a claim needs a source you do not have, insert a visible placeholder such as [CITE: evidence that X] and leave it for the author.
- Cite the original study for a finding, not a review or news article about it, unless the user asks otherwise; say when a citation is secondary.
- Follow the citation style the user names, consistently; do not mix styles.
Terms and consistency
- Define every technical term and abbreviation at first use, and use the abbreviation consistently afterwards; avoid abbreviations used fewer than three times.
- Use one term for one concept throughout. Do not vary terminology for elegance (for example "participants", "subjects" and "respondents" for the same people).
- Keep tense consistent with discipline conventions: present tense for established knowledge and for what the paper itself shows in its figures; past tense for what was done and found in this and earlier studies.
- Use the first person when the field and venue accept it ("we measured") rather than contorted passives; follow the style guide the user names (for example APA, AMA, Chicago or the journal's).
Numbers and precision
- Give exact numbers with units and the appropriate precision; keep decimal places consistent within a measure, and do not report more precision than the measurement supports.
- Report effect sizes with confidence intervals alongside p values; give exact p values (p < .001 below that) in the format the style guide requires.
- Use SI units and the number formatting conventions of the named style guide.
- Never change, round differently or "tidy" the author's data, statistics or quotations when editing prose. Flag apparent errors instead.
Style
- Put the main point of each paragraph in its first sentence and keep each paragraph to one idea.
- Prefer concrete, specific wording to vague intensifiers ("very", "highly", "novel", "crucial") and remove promotional language.
- Keep the author's voice and argument when editing; explain substantive changes rather than silently rewriting meaning.
- Remind the author to follow their venue's policy on disclosing AI assistance when you have drafted substantial text.
details
- kind
- Rule: standing instructions for everything the assistant does
- domain
- Research and science
- category
- Scientific writing
- level
- Beginner
- made for
- Researcher / scientist, Student, Writer / author, Editor
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install academic-writing-rules --target claude-codenpx skills add hermes-hq/hodios-dist --skill academic-writing-rules -a claude-codeRules are always-on instructions, so they are not in the plugins: add the skill, or paste the text into CLAUDE.md.
pairs well with
All of Scientific writingWrite a paper introduction
Writes a manuscript introduction that moves from the field to the gap to the study's aim using the CARS model, citing only supplied sources and using placeholders instead of invented references.
write-introduction-sectionWrite a results section
Writes a manuscript results section that reports findings in a logical order with exact statistics, effect sizes, confidence intervals and figure references, and no interpretation.
write-results-sectionWrite a discussion section
Writes a paper or thesis discussion covering principal findings, comparison with prior work, mechanisms, limitations, implications and future work, matching claims to the evidence. For authors.
write-discussion-sectionVerify citations and references
Checks a reference list or AI-written text for citations that may not exist or do not support their claims, with verification steps per item and no fabricated replacements.
verify-citationsSource and citation rules
Standing rules for research answers that require sources for factual claims, separate evidence from inference, and forbid invented citations, links or quotes. Use in any research or writing setup.
source-citation-rulesExplain research to the public
Turns a research paper into an accurate plain-language summary, press release, blog post or social thread without hype, keeping caveats, study type and effect sizes. Use for science communication.
explain-research-to-public