journal-adapt — Claude Code skill: tailor papers to journal style
journal-adapt — a dynamic writing skill generator that analyzes target-journal style from a corpus of published papers, then helps you revise your manuscript to match its conventions.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill journal-adapt -a claude-codeWhat journal-adapt does
journal-adapt reads your manuscript alongside papers from your target journal (or any corpus you choose), extracts writing patterns—argument flow, section structure, evidence style, rhetoric—and assembles a temporary writing skill for Claude Code. It works in two phases: first analyzes the corpus, then revises your manuscript section by section while keeping all technical content (equations, citations, results) unchanged.
You can layer optional inputs on top: a static writing skill as a foundation (bundled defaults exist for economics, ML, engineering), papers from adjacent fields, or examples from your lab. The skill never adds facts or recalculates results; it only reframes and restructures what is already there.
Works with PDFs via MinerU (optional; provide Markdown or plain text and you skip it). Request-driven workflow: tell it the target journal, corpus folder, which base skill to use (or none), and journal-adapt weights analysis toward the target journal.
What it helps with
- Rewrite a manuscript in the style of a specific journal while preserving all results and claims
- Build a custom writing skill from lab exemplars or coauthor samples
- Learn how a target journal writes by analyzing its corpus of papers
- Revise section by section and review each sentence before accepting changes
Example prompts for the agent
- Adapt my manuscript for the Journal of Environmental Economics and Management using these 15 papers as a style guide
- Build a writing skill for my paper by combining the standard economics guidelines with papers from my target journal
- Revise my Introduction section in the style of JEEM based on their recent issues
How to install journal-adapt
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill journal-adapt -a claude-code2Manually: put the files in place
~/.claude/skills/journal-adapt-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/journal-adapt-skill/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill journal-adapt -a codex2Manually: put the files in place
.agents/skills/journal-adapt-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill journal-adapt -a cursor2Manually: put the files in place
.cursor/skills/journal-adapt-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills paper-writing/journal-adapt-skill/SKILL.md2Manually: put the files in place
.github/skills/journal-adapt-skill/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill journal-adapt -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path paper-writing/journal-adapt-skillManually: put the files in place
.devin/skills/journal-adapt-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about journal-adapt
How do I install journal-adapt in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill journal-adapt-skill -a claude-code. The skill installs to ~/.claude/skills/journal-adapt-skill/SKILL.md and becomes available in Claude Code.
What does journal-adapt do and when should I use it?
The skill analyzes your target journal's writing style from its published papers, then rewrites your manuscript to match that style—structure, argument flow, tone, evidence patterns. Use it before submitting or if you want to learn how a specific journal writes without changing your facts or results.
Do I need MinerU to use journal-adapt?
MinerU is only required if your inputs are PDFs. If you provide your manuscript and corpus as Markdown or plain text, MinerU is not needed. If you have PDFs, either install MinerU or convert them to Markdown first.