Paper writing track
Takes a manuscript from target journal and outline through methods and results, introduction and discussion, title and abstract, and a pre-submission check, pausing for approval between steps.
Writes a research paper the way experienced authors do: venue and message first, then methods and results while the numbers are fixed, then the introduction and discussion that frame them, then the title and abstract, and finally a check of the whole manuscript as an editor and reviewer would read it. Each step writes one artifact and stops for approval, and later steps build on the approved artifacts instead of re-asking.
Only if [TARGET_JOURNAL] is given: Target journal: . Follow its article type, word limits and section headings throughout, and say where its guidelines are needed but not supplied.
Rules for every step:
- The data and the author's notes are the only source of results. Never invent numbers, participants, findings, references or quotations; mark gaps as [MISSING: ...] and list them at the end of each artifact.
- Cite only sources the author supplied, by the key or reference they gave. Every other claim that needs support gets [CITE: what the source must show].
- Keep claims proportional to the design: causal language only with a design that supports it, and the same conclusion stated the same way in every section.
- Track word counts against the journal's limits, and keep terminology, abbreviations, group names and numbers identical across sections.
- Remind the author once, at the start, to follow the journal's policy on disclosing AI assistance; the author is responsible for every word submitted.
Step 1: Target journal and outline
Fix the venue, the message and the shape of the paper before drafting anything.
- If no target journal was given, propose three to five candidates in tiers (reach, realistic, safe) with the reason each fits, marking fees, metrics and timelines as facts to verify, and ask the author to choose. If one was given, extract or ask for its article type, word and display-item limits, required sections, reference style and reporting requirements.
- Name the reporting guideline that applies to the design (for example CONSORT, STROBE, PRISMA, ARRIVE, COREQ, STARD, TRIPOD) or say that none does.
- Write the paper's message in one sentence and the two or three supporting findings, and check that the data actually support them.
- Produce an outline: working title, section headings, the point of each paragraph in one line, and the planned figures and tables with the result each shows.
- List what is missing from the study summary to write the methods and results.
Stop and wait for approval of the journal, message and outline, and for answers to the missing items.
Step 2: Methods and results
Draft the methods and results from the approved outline.
- Methods: write enough for another researcher to repeat the study, following the reporting guideline from step 1 - design, setting, participants or materials, interventions or exposures, outcomes and measurement, sample size reasoning, randomisation and blinding where relevant, analysis with software versions, missing data, ethics and consent (with placeholders for reference numbers), and data and code availability.
- Before the results, check the numbers: totals that add up, percentages that match counts, p values consistent with test statistics, intervals containing their estimates. List inconsistencies for the author instead of fixing them silently.
- Results: report in the order of the questions - flow and sample, primary outcome, secondary outcomes, then sensitivity and exploratory analyses labelled as such - with effect sizes, confidence intervals and exact statistics, figure and table references, and no interpretation. For qualitative studies, report each theme with its definition and verbatim quotes from the author's data.
- Draft table shells and figure captions for the display items in the outline.
- End with the reporting-guideline items still missing and every [MISSING] placeholder.
Stop and wait for approval and for corrected numbers before writing the framing sections.
Step 3: Introduction and discussion
Frame the approved results.
- Introduction: follow the field-gap-aim funnel (establish the territory, establish the niche, occupy it). Cite supplied sources only for what the author's notes say they show, and use [CITE: ...] elsewhere. End with aims or hypotheses that match the approved methods exactly. Avoid claims of being first unless the supplied literature supports them.
- Discussion: open with the main finding answering the question in one or two sentences; interpret it against the supplied literature, including studies that disagree; give mechanisms or explanations as possibilities, not findings; give strengths and limitations honestly, with the likely direction of each bias; state implications for research, practice or policy that the design can support; and close with a conclusion that matches the abstract-level message from step 1.
- Check consistency: the aim in the introduction, the question answered in the discussion and the conclusion use the same words and claim strength.
- Produce a citation map: each claim, the source key or placeholder, and whether the author's notes support it.
Stop and wait for approval.
Step 4: Title and abstract
Compress the approved paper.
- Write three title options: one declarative (states the finding), one descriptive (states the question and design), and one that fits the journal's conventions, each within its length limit. Include the design in the title or subtitle when the reporting guideline expects it.
- Write the abstract in the journal's format (structured headings or unstructured) and word limit: background and gap in one or two sentences, objective, design and participants, main results with the key numbers and intervals exactly as in the results section, and a conclusion no stronger than the discussion.
- Check every number and claim in the abstract against the approved sections and list any mismatch.
- Suggest keywords not already in the title, and highlights or a plain-language summary if the journal asks for them.
Stop and wait for approval.
Step 5: Pre-submission check
Read the assembled manuscript as the handling editor and a reviewer would, then list what to fix.
- Editor's desk check: fit with the journal's scope and article type, word and display-item limits, required sections and statements (ethics, consent, funding, conflicts of interest, data availability, author contributions, AI-use disclosure), reference style, and figure file requirements.
- Reviewer's read: the three most likely major criticisms and what would pre-empt each, in text the author can add.
- Reporting guideline: go through the checklist named in step 1 and list items missing with where to add them.
- Consistency: numbers identical across abstract, text, tables and figures; abbreviations defined once; terms and group names consistent; every figure and table cited in order.
- References: every [CITE] and [MISSING] placeholder still open, and a reminder to verify that each reference exists and supports its claim before submission.
- Give a final submission checklist, including a pointer to drafting the cover letter.
Say that this check does not guarantee acceptance and that a colleague outside the project is the best final reader.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Workflow: ordered steps with a checkpoint between them
- domain
- Research and science
- category
- Scientific writing
- level
- Intermediate
- made for
- Researcher / scientist, Student
- risk
- read-only
- version
- v1.1.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 paper-writing-track --target claude-codenpx skills add hermes-hq/hodios-dist --skill paper-writing-track -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-research-science@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Scientific writingShortlist target journals for a manuscript
Shortlists journals for a manuscript by scope, audience, article type, open-access costs and timelines, ranked in tiers, with facts to verify on each journal's site. For authors before submission.
choose-target-journalWrite a replicable methods section
Writes a manuscript methods section another researcher could replicate, following the relevant reporting guideline and flagging every missing detail. For authors drafting a paper or thesis.
write-methods-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 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 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-sectionWrite a paper abstract
Writes a structured or unstructured abstract within a word limit from a manuscript, keeping every number faithful to the source and showing where each appears. Use before submission.
write-abstract