gpsaggese/helpers / .claude/skills/research_idea.write_draft_paper
research_idea.write_draft_paper
VerifiedWrite a conference paper draft from a research idea
Goal
- Given a research idea, write a full conference paper draft using the
template in
papers/template/
Workflow
Read the Inputs
- Read the research idea passed by the user (a file under
research/ideas/*.md, or idea text pasted directly) - Read the paper template
papers/template/paper.md, including the comment block at the top, for usage and section structure - Read an existing paper for style and depth, e.g.
papers/Optimal_strategy_for_racket_sports/paper.md
Set Up the Paper Directory
- Derive a short
Title_Casename for the paper from the idea (e.g.RL_for_Automated_EDA); ask the user if the idea does not suggest an obvious name - Create
papers/<Paper_Name>/if it does not exist - Link
Makefiletopapers/template/Makefilewith a symlink, so all the paper dirs stay in sync, e.g.,ln -s ../template/Makefile papers/<Paper_Name>/Makefile- Do not copy or edit it for a single paper
- Copy
references.bib,ieee-template.typ, andfigures/frompapers/template/into the new directory - Do not copy
run_latex.sh,lint_latex.sh, ortemplate.pdf: they are obsolete or build outputs- Build with
make, which runsrun_latex.pyfor LaTeX andrender_images.pyfor diagrams - Lint with
lint_text.py -i <file> --use_dockerized_prettier
- Build with
- If the paper is written in LaTeX instead of Markdown, also copy
paper.texand keep the\input{papers/template/style.tex}line in it, shared by all papers - Do not overwrite an existing
paper.mdwithout confirming with the user - Say in the file
paper.mdhow it was generated, with this comment at the top of the file:<!-- Generated by `.claude/skills/research_idea.write_draft_paper/SKILL.md` -->
Write paper.md
- Fill in every
<...>placeholder with content derived from the idea: title, author(s) (the assignee(s) listed inresearch/ideas/README.mdfor this idea, plus GP Saggese), abstract, keywords, and all body sections - Keep the template's section structure (
Introduction,Related Work,Problem Formulation, core methodology,Discussion/Limitations,Conclusion); add, remove, or rename sections only where the template allows - Turn the idea's
Core Idea,Formalization,Key Examples, andResearch Topicsinto theIntroductionandProblem Formulationsections - Turn the idea's
QuestionsandNext stepsintoDiscussion/LimitationsandConclusion/Future Workmaterial - State plainly, per the template, what has not been validated (e.g. no computational implementation or empirical evaluation) instead of fabricating results the idea does not support
- Delete the template's guidance bullets and HTML comment once replaced with real content
Conventions
- Follow
.claude/skills/research_idea.rules.md,.claude/skills/markdown.rules.md, and.claude/skills/text.rules.md - Fit text in 80-90 character lines
- Cite claims with
[@key]and add matching entries toreferences.bib
Constraints
- Do not fabricate experimental results the idea does not support; state explicitly what remains unvalidated
- Do not overwrite an existing
paper.mdwithout user confirmation
Examples
papers/Optimal_strategy_for_racket_sports/paper.md
Verification
-
papers/<Paper_Name>/Makefileis a symlink to../template/Makefile -
papers/<Paper_Name>/containsreferences.bib,ieee-template.typ,figures/, andpaper.md - No
<...>placeholder remains inpaper.md - Every claim has a
[@key]citation with a matchingreferences.bibentry - Run
makeinpapers/<Paper_Name>/and confirmpaper.mdbuilds topaper.pdfwithout errors - The file
paper.mdsays that it was generated by.claude/skills/research_idea.write_draft_paper/SKILL.md
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |