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?
| If you are... | Use | Copy this starting point |
|---|---|---|
| Starting from an idea, notes, results, tables, or references | science-research-writing |
Use $science-research-writing. I have research materials but do not know how to organize them into a paper. |
| Turning a paper, manuscript, or research results into an academic slide deck | research-presentation |
Use $research-presentation to turn this paper into a source-grounded research presentation. |
| Trying to turn rough materials into Introduction, Methods, Results, Discussion, Abstract, or Title | science-research-writing |
Use $science-research-writing to help me draft the next useful manuscript section from the materials below. |
| Translating Chinese academic prose into publication-oriented English | sci-ssci-polishing |
Use $sci-ssci-polishing. Translate this into academic English, but do not add claims or citations. |
| Polishing an English manuscript without changing the science | sci-ssci-polishing |
Use $sci-ssci-polishing. Improve clarity and flow while preserving numbers, citations, limitations, and claim strength. |
| Building your own research Agent | Reuse the mechanisms | Start from the Evidence-Preserving Draft Contract and Claim-Strength Contract. |
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:
| Foundation | Skill | What it helps you do |
|---|---|---|
| The section-by-section and reverse-engineering pedagogy associated with Hilary Glasman-Deal's Science Research Writing | science-research-writing |
Decide what each section needs to accomplish, then turn ideas, notes, data, references, or drafts into the next useful manuscript artifact |
| Writing observations derived through a corpus pipeline beginning with a 1,000-paper SCI/SSCI metadata candidate pool | sci-ssci-polishing |
Translate or polish an existing manuscript while preserving data, citations, terminology, limitations, and claim strength |
| Evidence-first academic presentation design | research-presentation |
Turn papers and research materials into editable, source-grounded research presentations, with a narrative plan, evidence ledger, speaker notes, and render-based QA |
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
| What you have now | Use | What you get |
|---|---|---|
| An idea or research question | science-research-writing |
Questions to resolve, a materials checklist, and a practical next step |
| Notes, data, references, or a protocol | science-research-writing |
A paper plan or section draft grounded only in supplied materials |
| A partial or complete draft | science-research-writing |
Revision, consistency checks, or an evidence audit |
| Chinese academic prose or an English manuscript | sci-ssci-polishing |
Academic English plus a preservation audit |
| A paper or research results that need to become slides | research-presentation |
A narrative outline, editable deck plan, source map, notes, and visual QA checklist |
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