autosurvey-paper-retrieval

Installed Root

Resolve the installed reasflow-dev skills root before running packaged scripts:

REASFLOW_SKILLS_ROOT="${REASFLOW_SKILLS_ROOT:-}"
if [ -z "$REASFLOW_SKILLS_ROOT" ]; then
  if [ -d ./.agents/skills ]; then
    REASFLOW_SKILLS_ROOT="$(pwd)/.agents/skills"
  elif [ -d "$HOME/.agents/skills" ]; then
    REASFLOW_SKILLS_ROOT="$HOME/.agents/skills"
  else
    echo "reasflow shared skills not found in ./.agents/skills or $HOME/.agents/skills" >&2
    exit 1
  fi
fi

REASFLOW_PRIVATE_SKILLS_ROOT="${REASFLOW_PRIVATE_SKILLS_ROOT:-}"
if [ -z "$REASFLOW_PRIVATE_SKILLS_ROOT" ]; then
  if [ -d ./.codex/reasflow-skills ]; then
    REASFLOW_PRIVATE_SKILLS_ROOT="$(pwd)/.codex/reasflow-skills"
  elif [ -d "$HOME/.codex/reasflow-skills" ]; then
    REASFLOW_PRIVATE_SKILLS_ROOT="$HOME/.codex/reasflow-skills"
  else
    echo "reasflow private skills not found in ./.codex/reasflow-skills or $HOME/.codex/reasflow-skills" >&2
    exit 1
  fi
fi

AutoSurvey Paper Retrieval

Overview

Build a reusable paper pool before drafting survey prose. Keep retrieval traces in survey/library/ so outline, section writing, and related-work synthesis all cite the same evidence base.

This skill is the executable replacement for the upstream literature_* tool family. Its default source policy is ReaScholar first, with Semantic Scholar as a metadata and graph supplement/fallback:

• search ~= literature_search
• paper ~= literature_get_paper
• citations ~= literature_get_citations
• references ~= literature_get_references
• bibtex turns retrieval JSON into references.bib

Use native Codex web search first when you need broad discovery or freshness. Use this script when you need reproducible paper metadata, citation graphs, reference graphs, or BibTeX output under survey/. Set SEMANTIC_SCHOLAR_API_KEY in the environment when S2 enrichment or citation/reference graph calls are needed; never store the key in generated files.

Installed Paths

Set SKILL_ROOT="$REASFLOW_PRIVATE_SKILLS_ROOT/survey/autosurvey-paper-retrieval" before invoking the packaged helper script.