background-research

Searches internal Marin artifacts and external literature to produce cited prior-work research briefs.

3.2k|266|Updated Mar 22, 2024
One-click install
npx skills add https://github.com/marin-community/marin --skill background-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: background-research
Source: https://github.com/marin-community/marin/tree/main/.agents/skills/background-research
Command: npx skills add https://github.com/marin-community/marin --skill background-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Research and design decisions in the Marin project often lack a systematic record of prior work, leading to repeated experiments, missed contradictions, and unsupported claims. This Skill performs an explicitly requested prior-work search across internal Marin sources and external literature, then produces a cited, structured brief.

Core Features & Use Cases

  • Tiered Effort Levels: Choose low (3-7 min), medium (10-15 min), or high (30-60 min) effort depending on decision cost, with defined stop rules and provenance depth.
  • Ordered Source Search: Searches the current issue, GitHub issues/PRs, docs/reports, logbooks, experiment code, W&B runs, and external papers in a defined priority order, including adversarial query passes.
  • Structured Output Contract: Produces a brief with an evidence map, ranked next experiments, hypothesis queue updates, and a source ledger, filed into the logbook, issue, or .agents/projects/<slug>/research.md.
  • Use Case: Before launching an expensive pretraining run, request a high-effort background research pass to gather internal experiment history and external scaling-law literature, then receive a cited brief with falsifiable next-experiment hypotheses.

Quick Start

Ask the agent to run a medium-effort background research pass on your current design question and file the cited brief in the project research file.

Frequently Asked Questions about background-research

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

FAQPage Schema
How do I run a prior-work search before a Marin experiment?

Request a background research pass and specify an effort level: low, medium, or high. The skill searches internal Marin issues, reports, logbooks, and code plus external literature, then files a cited brief in the issue, logbook, or project research file.

What sources does a background research brief cover?

It covers the current issue or logbook, GitHub issues and PRs, docs/reports, experiment definitions, W&B runs, and external papers, blog posts, and codebases. Medium and high efforts also include at least one adversarial query family.

When should I use high effort versus low effort research?

Use low effort for small follow-ups with strong existing context, and high effort for expensive runs, architecture changes, data or evaluation decisions, or public claims. Medium is the default for typical design and experiment questions.

Does the research brief include negative or contradictory results?

Yes, contradictions and negative results are treated as first-class evidence in the evidence map. Meaningful not-found results are also recorded when a search was expected to find something and did not.

Where is the background research output stored?

The brief is written to the parent workflow's logbook, the experiment issue, or .agents/projects/<slug>/research.md for design-doc work. Transient conversation is never used as the durable record.