SCI/SSCI Research Writing Skills

Turn your research into a clear, well-structured paper—section by section.

Polish the writing. Never rewrite the science. This repository provides open-source Agent Skills for planning, drafting, revising, translating, and polishing SCI/SSCI papers while preserving meaning, data, citations, limitations, and claim strength.

Designed for Agent workflows such as Codex, Claude Code, WorkBuddy-style research agents, and other systems that support reusable Skill instructions.

Paper to Slides showcase

research-presentation turns a paper into a source-grounded, editable research presentation. The full showcase now covers six cross-disciplinary cases; the network-epidemiology case also includes two complete 12-slide visual passes.

Source paper: arXiv:2607.25475. The repository stores the canonical paper link, not the source PDF.

Education research	Epidemiology	Materials science

Sociology	Statistics	Full gallery
		Browse all six cases →

Which Skill should I use?

Why star this repo?

Star this repository if you want a growing open-source toolkit for:

• writing research papers section by section;
• polishing SCI/SSCI manuscripts without changing the science;
• protecting numbers, citations, terminology, limitations, and claim strength during AI-assisted revision;
• building academic-writing Agents with reusable evidence-preserving rules;
• contributing examples, benchmarks, translations, and new research-writing Skills.

Two foundations, one research-writing workflow

This repository does three connected jobs:

In plain language: the writing Skills help build and refine the paper; research-presentation carries the evidence into a talk without flattening the science. Scientific judgment remains with the author.

Building a research Agent?

You can reuse the repository's Evidence-Preserving Draft Contract, Claim-Strength Contract, and Target-Journal Model Builder in your own project.

Reuse the mechanisms · Cite this repository · Add your project

Choose where you are

Start with one sentence

Use $science-research-writing to help me write my paper.
Here are the materials I currently have: [attach files or paste text]

The Skill reads what you have, identifies whether the next useful result is a plan, draft, revision, or audit, and proceeds without requiring a long intake prompt or an internal mode selection.

Getting started · Use cases · Copyable inputs · Output guide

For paper-to-slides work, start with the Research Presentation quick start and use cases.

Copy-paste examples

From materials to a paper structure

Use $science-research-writing.
I have finished my study, but I do not know how to organize it into a paper.

Research question:
[paste your research question]

Methods:
[paste what you did]

Main results:
[paste key findings, tables, or notes]

Target journal or field:
[paste if available]

Polish without changing the science

Use $sci-ssci-polishing.
Please polish this Discussion paragraph for academic clarity.
Do not change numbers, citations, terminology, limitations, or claim strength.
If any sentence sounds unsupported or overclaimed, flag it instead of fixing it silently.

Text:
[paste paragraph]

Install

Node.js 18 or later is required.

# Start from research materials
npx skills add Yila-AI/sci-ssci-skills --global --agent codex --skill science-research-writing --yes --copy

# Translate or polish an existing draft
npx skills add Yila-AI/sci-ssci-skills --global --agent codex --skill sci-ssci-polishing --yes --copy

# Turn a paper or research materials into an academic presentation
npx skills add Yila-AI/sci-ssci-skills --global --agent codex --skill research-presentation --yes --copy

List all installable Skills:

npx skills add Yila-AI/sci-ssci-skills --list

Use only one Skill?

You do not need to clone the complete repository or point an Agent at the repository root merely to run one Skill. The --skill ... --copy commands above copy only the selected runtime Skill into your Agent's Skills directory.

For manual installation or downstream integration, download the packaged sci-ssci-polishing Skill from the latest Lean Release. The full repository keeps the corpus, benchmarks, provenance, and examples available for researchers who want to inspect how the Skill was built and evaluated.

Why turn Science Research Writing into an Agent workflow?

Hilary Glasman-Deal's Science Research Writing: For Native and Non-Native Speakers of English is valued because it teaches more than phrases and grammar. Its section-by-section approach asks what a reader needs from each part of an empirical paper, while its reverse-engineering pedagogy encourages researchers to examine successful papers in their own field and adapt recurring functions without copying sentences.

An independent review reports that the first edition sold more than 35,000 copies and was translated into Chinese, Korean, and Japanese (Anna Clemens, 2020).

The central idea can be summarized as seven reader questions:

science-research-writing operationalizes this general approach for Agent use and adds automatic task routing, target-journal modeling, evidence provenance, author-confirmation boundaries, and deterministic draft checks.

It is an independent, unofficial project. It is not affiliated with or endorsed by the author or World Scientific, and it does not reproduce the book, exercises, answer key, phrase lists, sample passages, or page content. See the privacy and copyright boundaries.

Fluent is not always faithful

Suppose 120 university students rate nine milk-tea recipes. The evidence shows that 30%-sugar oolong milk tea receives the highest average rating among these participants.

Supported by the study:

Among the participants in this study, 30%-sugar oolong milk tea received the highest rating.

Not supported by the study:

30%-sugar oolong milk tea is the world's best milk-tea recipe.

The first statement reports a bounded result. The second silently turns a local finding into a universal claim. Both Skills are designed to detect this kind of drift: evidence can be clarified, organized, translated, and polished, but it must not be silently strengthened.

Read the complete milk-tea walkthrough · 查看中文完整案例

What the two Skills add

science-research-writing

• routes an idea, materials, partial draft, or full draft to the next useful task;
• maps Introduction, Methods, Results, Discussion, Conclusion, Abstract, and Title by reader question and rhetorical function;
• models target-journal functions and variation without storing copied prose;
• records the source of consequential statements and marks missing evidence;
• checks numbers, citations, protected terms, and claim-strength markers;
• gives novice-readable outputs and asks no more than one blocking question at a time.

research-presentation

• turns a paper, manuscript, figures, tables, or research notes into a source-grounded talk plan;
• keeps an evidence ledger and source anchors for consequential claims;
• chooses a narrative arc for journal club, lab meeting, conference talk, seminar, or thesis defense;
• produces editable slide content, speaker notes, and a render-based QA report;
• preserves uncertainty, limitations, and claim strength instead of optimizing for visual polish alone.

sci-ssci-polishing

• translates Chinese academic prose into publication-oriented English;
• polishes English paragraphs and complete manuscript sections;
• improves information order, clarity, cohesion, and academic tone;
• preserves numbers, statistics, technical entities, citations, null results, limitations, and conclusions;
• refuses to invent mechanisms, references, results, or implications merely to make prose sound more complete.

The 1,000-paper evidence pool—what it does and does not mean

The polishing Skill began with a 1,000-paper SCI/SSCI metadata candidate pool and used staged screening to build a balanced core portfolio:

1,000-paper metadata candidate pool
                 ↓
        200-paper balanced shortlist
                 ↓
          60-paper core portfolio
        ↙           ↓           ↘
40 distillation  10 calibration  10 sealed blind evaluation

The 60-paper portfolio contains 30 SCI and 30 SSCI papers across nine broad discipline clusters. The 40-paper distillation split contains 20 SCI and 20 SSCI papers from 28 journals, yielding aggregate observations from 1,750 usable paragraphs and 220,158 words.

Here, distillation does not mean model fine-tuning or copying journal sentences. It means abstracting recurring rhetorical functions, information order, evidence boundaries, and failure modes into reusable editing rules. The 1,000-paper pool is a screening universe: it is not a claim that 1,000 full texts were downloaded, read, distilled, or used to train a model.

Corpus method · Selection method · Corpus summary · Public metadata

Build on these mechanisms

The following mechanisms are documented as reusable components for other research Agents and academic-writing projects:

Additional components include the Section Function Map, Content Provenance Ledger, Title-Paper Promise Check, and Draft Invariant Checker.

Suggested short credit:

**Credit:** The evidence-preserving research-writing workflow is adapted from
[Yila-AI/sci-ssci-skills](https://github.com/Yila-AI/sci-ssci-skills),
including its Evidence-Preserving Draft Contract and Claim-Strength Contract.

Reuse remains subject to the repository license and any applicable third-party rights.

Used, credited, or adapted by

This section lists public projects that use, credit, adapt, or discuss mechanisms from this repository.

Using or adapting this workflow in your own research Agent, academic-writing tool, or open-source project? Open an issue or pull request to add your project here. Please include a short description and a public link.

Evaluation

Evaluation claims remain Skill-specific.

sci-ssci-polishing

Synthetic cases · Synthetic outputs · Blind retention report

science-research-writing

The test set and scoring rubric were frozen before implementation. Comparative results will be added only after raw outputs, model settings, case-level scores, failures, and limitations are available.

Benchmark protocol · Frozen cases · Evaluation rubric · Development smoke tests

These evaluations support narrow safety and consistency claims. They do not prove journal acceptance, universal disciplinary coverage, scientific correctness, or superiority to domain experts and professional editors.

Copyright, data, and professional boundaries

• The repository contains no book PDF, article PDF, subscription full text, extracted paper paragraphs, phrase bank, or private access trace.
• Public corpus tables contain bibliographic metadata, screening annotations, and aggregate results only.
• SCI and SSCI describe corpus and user scope. This independent project is not affiliated with Clarivate, any journal, author, or publisher.
• Both Skills are public beta software and do not replace author, domain-specialist, statistical, ethical, or professional editorial review.

Citation and license

See CITATION.cff for formal citation metadata. Original code, Skill instructions, and project documentation are licensed under the Apache License 2.0. Third-party facts, names, and external resources remain subject to their source terms.