write-background

Draft manuscript background sections from literature summaries and citations.

3|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/braselog/researchAssistant --skill write-background
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-background
Source: https://github.com/braselog/researchAssistant/tree/main/.ra/skills/write-background
Command: npx skills add https://github.com/braselog/researchAssistant --skill write-background

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafts or updates the Background/introduction section using literature summaries from .research/literature/. This feature helps researchers synthesize context, current approaches, and gaps without manual writing, ensuring alignment with project aims and cited sources.

Core Features & Use Cases

  • Literature-informed background: Generates background paragraphs by integrating context, existing approaches, gaps, and your contribution based on literature summaries in .research/literature/ and citations in .bib files.
  • Funnel structure guidance: Produces a well-structured Background following the funnel model (broad context → current approaches → gaps → your contribution).
  • Project alignment: References project aims in .research/project_telos.md to ensure the background supports study goals.
  • Update existing drafts: If manuscript/background.md exists, updates content while preserving user edits.
  • Citation consistency check: Verifies citations against .bib sources and compiles a references list.

Quick Start

Use the /write_background command after completing literature review to generate or update manuscript/background.md from the literature pool. Ensure .research/literature/ contains summaries and .bib contains citations, and that .research/project_telos.md defines the project aims.

Frequently Asked Questions about write-background

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I draft a manuscript background section from my literature summaries?

Draft a manuscript background by synthesizing literature summaries from .research/literature/ and citations in .bib files. The tool generates structured paragraphs following the funnel model: broad context, current approaches, gaps, and your contribution.

How does a funnel structure work for a research paper introduction?

A funnel structure for a research paper introduction narrows from broad context to current approaches, identifies gaps, and highlights your contribution. This tool generates background sections following this exact model using your literature summaries.

Do I need a .bib file to generate a cited research background?

Yes, you need a .bib file containing citations to generate a cited research background. The tool verifies citations against .bib sources in .research/literature/ and compiles a references list to ensure citation consistency.

Can I update an existing manuscript draft without losing my manual edits?

Yes, you can update an existing manuscript draft without losing manual edits. If manuscript/background.md exists, the tool updates content while preserving your previous edits and integrating new literature summaries.

How do I align my literature review with my project aims for the introduction?

Align your literature review with project aims by defining goals in .research/project_telos.md. The tool references this file to ensure the generated background section supports your specific study goals and contributions.

What is the best way to synthesize research gaps for a manuscript background?

Synthesize research gaps for a manuscript background by integrating existing approaches and context from .research/literature/ summaries. The tool identifies gaps and positions your contribution to align with project aims.