feynman/skills/research/paper-writing/SKILL.md

name, description

name	description
paper-writing	Use this when the task is to turn research notes, experiments, or a literature review into a polished paper-style writeup with Markdown and LaTeX.

Paper Writing

When To Use

Use this skill for:

• research reports that should read like a paper
• internal memos with equations or formal structure
• polished writeups of experiments or literature reviews
• converting rough notes into a coherent draft

Procedure

1. Make sure the underlying claims are already grounded in sources, experiments, or explicit caveats.
2. Build the draft around a proper research structure:
   • title
   • abstract
   • introduction or problem statement
   • related work
   • approach, synthesis, or methodology
   • evidence, experiments, or case studies
   • limitations
   • conclusion
3. Use Markdown by default.
4. Use LaTeX only where equations or notation genuinely improve clarity.
5. Keep claims falsifiable and scoped.
6. Save polished drafts to papers/.
7. Add a Sources appendix with direct URLs to all inspected references.

Pitfalls

• Do not use LaTeX for decoration.
• Do not make a draft look more certain than the evidence supports.
• Do not hide missing citations or weak evidence; flag them.

Deliverable

A readable paper-style draft with:

• explicit structure
• traceable claims
• equations only where useful
• limitations stated plainly