PluginBench
Skill
Pass
Audit score 90

related-work-writing

lingzhi227/agent-research-skills

Write publication-quality Related Work sections that organize literature by theme and position your research.

What is related-work-writing?

This skill generates Related Work sections for academic papers by analyzing your contributions, organizing prior work into thematic clusters, and clearly contrasting your approach with existing methods. Use it when drafting or revising the Related Work section of a research paper.

  • Analyzes paper contributions and identifies key technical components needing literature context
  • Organizes collected papers into thematic clusters rather than chronological order
  • Writes comparison-focused paragraphs that explain how your work differs from prior approaches
  • Ensures proper citation formatting and verifies all cited papers are in the bibliography
  • Positions your research relative to the broader literature landscape
  • Maintains fair acknowledgment of prior work strengths while clarifying limitations

How to install related-work-writing

npx skills add https://github.com/lingzhi227/agent-research-skills --skill related-work-writing
Prerequisites
  • Current paper draft or method description
  • Collected literature in BibTeX format, paper summaries, or literature review notes
Claude Code
Cursor
Windsurf
Cline

How to use related-work-writing

  1. 1.Provide your paper draft and collected literature (BibTeX entries or summaries) as input
  2. 2.The skill analyzes your key contributions and technical components
  3. 3.Literature is grouped into thematic clusters (problem formulation, methodology, application domain, evaluation)
  4. 4.For each theme, a paragraph is generated with topic sentence, key work descriptions, and contrasts with your approach
  5. 5.Review the output to verify all citations exist in your .bib file and novelty is clearly positioned
  6. 6.Refine the section to 1-2 pages (single column) or 0.5-1 page (double column) as needed

Use cases

Good for
  • Writing the Related Work section for a new research paper draft
  • Revising an existing Related Work section to better position your contributions
  • Organizing a large literature review into thematic groups for a survey paper
  • Identifying gaps in your literature coverage by comparing your work against organized themes
  • Ensuring your paper's novelty is clearly articulated relative to cited prior work
Who it's for
  • Academic researchers writing conference or journal papers
  • PhD students structuring literature reviews for dissertations
  • Authors of survey papers organizing broad research landscapes
  • Research teams positioning new methods against existing approaches

related-work-writing FAQ

What format should I provide the literature in?

You can provide BibTeX entries, paper summaries, or literature review notes. The skill works with any organized collection of prior work references.

How does this differ from just listing papers chronologically?

This skill organizes papers by research theme or direction, making it easier to show how your work relates to different research areas and what makes your approach novel.

Should I include every paper I've read?

No. Include papers that are directly relevant to your contributions. The skill helps you explain why each cited paper matters and how it relates to your work.

Can this skill help if I'm not sure how to position my work?

Yes. By analyzing your paper's contributions and comparing them against organized literature themes, the skill helps clarify what makes your work distinct.

What if a prior method could apply to my setting but I didn't compare against it experimentally?

The skill follows the rule to explain inapplicability—you should either add it to experiments or clearly explain why direct comparison isn't relevant to your contribution.

Full instructions (SKILL.md)

Source of truth, from lingzhi227/agent-research-skills.


name: related-work-writing description: Write Related Work sections that compare and contrast prior work with your approach. Organize by theme, cite broadly, and explain how your work differs. Use when writing or improving the Related Work section of a paper. argument-hint: [paper-draft]

Related Work Writing

Generate publication-quality Related Work sections with proper citations and thematic organization.

Input

  • $0 — Current paper draft or method description
  • $1 — Collected literature (BibTeX entries, paper summaries, or literature review notes)

References

  • Related work writing prompts and strategies: ~/.claude/skills/related-work-writing/references/related-work-prompts.md

Workflow

Step 1: Analyze the Paper's Contributions

  • Read the current paper draft (especially Methods and Introduction)
  • Identify the key contributions and novelty claims
  • List the technical components that need literature context

Step 2: Organize Literature by Theme

Group related papers into thematic clusters:

  • Each cluster should represent a research direction or technique
  • Common themes: problem formulation, methodology family, application domain, evaluation approach
  • Order themes from most to least relevant to your work

Step 3: Write Each Theme Paragraph

For each thematic group:

  1. Topic sentence — Introduce the research direction
  2. Describe key works — Summarize 2-5 representative papers
  3. Compare and contrast — How does each approach differ from yours?
  4. Transition — Connect to the next theme or to your contribution

Step 4: Refine

  • Ensure every cited paper has a clear reason for inclusion
  • Check that your work's novelty is clear from the comparisons
  • Verify all \cite{} keys exist in the .bib file
  • Aim for 1-2 pages (single column) or 0.5-1 page (double column)

Rules

  • Compare and contrast, don't just describe — "Unlike [X] which assumes..., our method..."
  • Organize by theme, not chronologically — Group by research direction
  • Cite broadly — Not just the most popular papers; include recent and diverse work
  • Be fair — Acknowledge strengths of prior work before stating limitations
  • Explain inapplicability — If a method could apply to your setting, explain why you don't compare experimentally, or add it to experiments
  • Use present tense for established facts — "Smith et al. propose..." or "This approach uses..."
  • End with positioning — The final paragraph should clearly position your work relative to all discussed prior work

Related Skills

  • Upstream: literature-search, literature-review, citation-management
  • Downstream: paper-writing-section
  • See also: survey-generation