# Expand References

> Expand one to three seed papers into nearby, bridge, foundational, methodological, recent, and survey follow-ups

- **Type:** Skill
- **Install:** `agentstack add skill-zongmin-yu-semantic-scholar-skills-expand-references`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zongmin-yu](https://agentstack.voostack.com/s/zongmin-yu)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zongmin-yu](https://github.com/zongmin-yu)
- **Source:** https://github.com/zongmin-yu/semantic-scholar-skills/tree/main/skills/expand-references

## Install

```sh
agentstack add skill-zongmin-yu-semantic-scholar-skills-expand-references
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Expand References

Turn one to three seed papers into a structured follow-up reading list.
Use this when the human already has anchor papers and wants the next papers to read.

## Arguments

- Positional arguments are the seed papers. Quote multi-word titles.
- `--negative ` may be repeated to push the workflow away from an unwanted cluster.
- `--pool all-cs|recent` selects the Semantic Scholar recommendation pool.
- `--limit ` controls how many raw recommendations are requested before reranking.
- `--per-bucket-limit ` caps each curated bucket after scoring.

## Workflow

1. Run `python scripts/run.py ...`.
2. Read `result.closest_neighbors` for the immediate next reads.
3. Read `result.bridge_papers` for papers that connect multiple seeds.
4. Read `result.foundational`, `result.methodological`, `result.recent`, and `result.surveys_or_benchmarks` for curated slices of the neighborhood.
5. If the result is sparse or off-topic, adjust the seed set or add `--negative` papers and rerun.

## Output

- The script prints the unified JSON envelope described in `output_contract.md`.
- The underlying workflow result is `ExpandReferencesResult.to_dict()`.
- `result.notes` captures dropped records and other execution notes.

## When To Escalate

- Fewer than one clear seed paper is available.
- The resolved seeds are obviously duplicates or wrong papers.
- The output is empty even after trying better seeds or a different recommendation pool.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zongmin-yu](https://github.com/zongmin-yu)
- **Source:** [zongmin-yu/semantic-scholar-skills](https://github.com/zongmin-yu/semantic-scholar-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zongmin-yu-semantic-scholar-skills-expand-references
- Seller: https://agentstack.voostack.com/s/zongmin-yu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.