paper-to-social — Claude Code skill: what it does, how to install
paper-to-social adapts academic papers and preprints into platform-native posts for LinkedIn, X, Xiaohongshu, and Substack.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-to-social -a claude-codeWhat paper-to-social does
This skill processes manuscripts in .docx, .tex, .pdf, or .md. For Word files, it uses Python to parse XML, targeting word/footnotes.xml specifically to capture author affiliations accurately. The extraction pulls the research puzzle, dataset details, empirical effect sizes, and practical takeaways.
Outputs go into dedicated files: posts/linkedin.md, posts/x.md, posts/xiaohongshu.md, and posts/substack.md. Without verified editorial acceptance, the workflow labels unaccepted papers strictly as working drafts.
Parsing complex PDFs requires pymupdf or pypdf.
What it helps with
- convert an empirical working paper into an X thread
- draft a structured LinkedIn summary from a research draft
- turn an academic manuscript into a Substack essay
- extract author affiliations from Word document footnotes
Example prompts for the agent
- Turn manuscript.docx into an X thread and a LinkedIn post
- Draft a Substack essay based on paper.pdf
- Create a Xiaohongshu post summarizing draft.tex
How to install paper-to-social
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-to-social -a claude-code2Manually: put the files in place
~/.claude/skills/paper-to-social/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paper-to-social/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-to-social -a codex2Manually: put the files in place
.agents/skills/paper-to-social/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-to-social -a cursor2Manually: put the files in place
.cursor/skills/paper-to-social/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills promote-skill/paper-to-social/SKILL.md2Manually: put the files in place
.github/skills/paper-to-social/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-to-social -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path promote-skill/paper-to-socialManually: put the files in place
.devin/skills/paper-to-social/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 paper-to-social
How to install paper-to-social in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill paper-to-social -a claude-code. The skill configuration resides at ~/.claude/skills/paper-to-social/SKILL.md.
What does paper-to-social do?
It summarizes academic drafts into tailored social media copy for multiple platforms. Each draft focuses on the core empirical findings and practitioner takeaways.
How does paper-to-social handle docx files?
It parses the internal XML using Python scripts. Author affiliations are pulled directly from word/footnotes.xml rather than inferred from funding text.