scholaraio

Academic Writing

ScholarAIO’s writing support is organized as a small set of specialized skills plus one routing skill. These work best through an agent host that can load ScholarAIO skills; the examples below use Claude Code-style slash-skill names.

Start Here

Academic Writing Router (/academic-writing)

Use this first when the user knows the deliverable they want, but not which writing workflow to use. It routes by outcome, writing stage, and document type, then points to the right specialized skill or skill combination.

Nature Workflow Bridge (/nature-workflow)

Use this when the user explicitly asks for Nature Skills, nature-skills, Nature-style, Nature-family/CNS, high-impact journal, or Springer Nature workflows. It bridges to the upstream nature-* skill index for figures, polishing, writing, reviewer critique, citation, Data Availability, paper reading, reviewer response, paper-to-PPT, and academic search. Direct upstream skill use is preferred when available; ScholarAIO’s local skills are fallbacks, not simplified replacements.

See the Nature Workflow Quick Start for common scenarios, example prompts, expected outputs, and the production demo fixture.

Choose By Deliverable

Deliverable Recommended skill path
Long-form literature review / survey /academic-writing -> /literature-review
Guided deep reading of a single paper /academic-writing -> /paper-guided-reading
Paper section draft (Introduction, Method, Results, Discussion, Conclusion) /academic-writing -> /paper-writing
Nature Skills / Nature-style / high-impact journal workflow /nature-workflow -> upstream nature-* skill when available, otherwise ScholarAIO fallback
Response letter / rebuttal /academic-writing -> /review-response
Research-gap memo / topic scouting /academic-writing -> /research-gap
Final prose cleanup / de-AI-fication / style transfer /academic-writing -> /writing-polish
Reference validation /citation-check
Formal Word report /academic-writing -> writing skill + /document
Presentation deck / advisor update slides /academic-writing -> writing skill + /document
Poster content package /academic-writing -> /poster
Technical or special-topic report /academic-writing -> /technical-report

Choose By Writing Stage

Stage Recommended skill
Define scope and output format /academic-writing
Prepare a Nature-style, CNS, high-impact, or upstream Nature Skills workflow /nature-workflow
Collect and organize papers /workspace
Read and summarize evidence /show
Guided deep reading of a paper /paper-guided-reading
Draft review narrative /literature-review
Draft manuscript sections /paper-writing
Identify open questions /research-gap
Build a technical report or briefing /technical-report
Build a poster-ready content package /poster
Respond to reviewers /review-response
Polish wording and match journal tone /writing-polish
Verify citations before delivery /citation-check
Turn Markdown/content into DOCX or PPTX /document

Detailed Writing Guides

For tactical, format-specific rules and checklists, see the guides in docs/writing-guide/:

Current Writing Skills

Nature Workflow (/nature-workflow)

Bridges to the upstream nature-skills bundle. Use it for explicit Nature Skills, Nature-style, Nature-family/CNS, high-impact journal, or Springer Nature tasks across figure making, polishing, manuscript writing, reviewer-style critique, citation support, Data Availability, full-paper readers, reviewer response, paper-to-PPT, and academic search. Submission package is only one scenario. If the original upstream skill is unavailable, it routes to ScholarAIO fallbacks and labels the result accordingly.

Literature Review (/literature-review)

Generates a structured literature review from papers in a workspace. Organizes by topic, builds narrative, identifies gaps, and exports BibTeX.

Paper Guided Reading (/paper-guided-reading)

Starts from a fuzzy keyword or research interest, searches the local library, confirms the target paper with the user, then loads full text for structured deep reading using a 20-point analytical framework. Outputs conversational insights rather than long reports.

Paper Writing (/paper-writing)

Assists with drafting specific paper sections: Introduction, Related Work, Method, Results, Discussion, Conclusion. Uses workspace papers for citations.

Writing Polish (/writing-polish)

Polishes academic prose, removes AI-generated patterns, and adapts writing to a target style. Supports English and Chinese.

Review Response (/review-response)

Drafts point-by-point responses to peer reviewer comments, locating evidence from workspace papers and the manuscript.

Research Gap (/research-gap)

Identifies unexplored areas and open questions by analyzing literature in a workspace through topic clustering, citation analysis, and cross-paper comparison.

Citation Check (/citation-check)

Verifies citations in AI-generated or human-written text against the knowledge base. Catches hallucinated references and wrong metadata.

Technical Report (/technical-report)

Builds report-oriented workflows for technical investigations, topic reports, and recommendation-style briefings. It chooses the right analysis backbone, then organizes the result into a report structure.

Poster (/poster)

Builds poster-oriented workflows for conference posters and visual one-page summaries. It keeps the focus on sections, message hierarchy, and figure-to-text balance rather than paper-style prose.

Document (/document)

Generates and inspects Office deliverables such as DOCX and PPTX. Use it with the writing skills above when the user wants a polished report, slide deck, or poster-style package rather than just Markdown text.

Deliverable Notes

Typical Workflow

  1. Create a workspace with /workspace to organize relevant papers.
  2. Start with /academic-writing if the target output is not yet mapped to a specific workflow.
  3. Use the specialized writing skill for the content work.
  4. Run /citation-check before final delivery if the output contains citations.
  5. Use /document when the user wants a formal DOCX or PPTX deliverable.
  6. Save outputs in workspace/<name>/.