# Deepscan Monitor

> Run and monitor PapersFlow DeepScan jobs. Use when the user wants long-running research progress, intermediate findings, final reports, or plotting from a completed run.

- **Type:** Skill
- **Install:** `agentstack add skill-papersflow-ai-papersflow-skills-deepscan-monitor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [papersflow-ai](https://agentstack.voostack.com/s/papersflow-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [papersflow-ai](https://github.com/papersflow-ai)
- **Source:** https://github.com/papersflow-ai/papersflow-skills/tree/main/skills/deepscan-monitor

## Install

```sh
agentstack add skill-papersflow-ai-papersflow-skills-deepscan-monitor
```

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

## About

# DeepScan Monitor

Use this skill when the user wants Claude to manage a longer-running PapersFlow research workflow instead of a single search call.

## Workflow

1. Use `run_deepscan` to start the job.
2. Immediately tell the user that the run is asynchronous.
3. Poll with `get_deepscan_live_snapshot` for the best live view of:
   - progress
   - status message
   - checkpoint state
   - top papers
   - partial summary
   - key findings
4. Fall back to `get_deepscan_status` if the user only wants lightweight progress checks.
5. Once `finalReportAvailable` is true or the run is completed, call `get_deepscan_report`.
6. Use `summarize_evidence` when the user wants a cross-report summary from stored DeepScan history.
7. Use `run_python_plot` only after you have stable report data worth plotting.

## Important Behavior

- Do not imply the MCP server will push completion notifications into Claude automatically.
- Poll deliberately and explain that the run is being checked.
- Prefer `get_deepscan_live_snapshot` over `get_deepscan_status` when the user wants richer live information.
- If a report is not ready yet, say that clearly and keep the next action obvious.

## Progress Update Style

When a run is still active, summarize:

- current status
- progress percentage
- current stage or status message
- any checkpoint question
- notable live papers
- key findings if available

Keep updates brief unless the user asks for more detail.

## Plotting Guidance

Use `run_python_plot` only for meaningful visualizations after you have stable report outputs, for example:

- papers by year
- citation distribution
- venue distribution
- grouped comparison across a small number of finished runs

Do not generate plots for sparse or obviously low-quality data without saying so.

## Examples

- User asks: "Run a DeepScan on evaluation benchmarks for agentic retrieval systems and keep me posted."
- User asks: "Check how my DeepScan is progressing and tell me the key findings so far."
- User asks: "The run is finished, summarize the final report and plot papers by year."
- User asks: "Summarize the evidence from my recent DeepScan reports on protein structure prediction."

## Source & license

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

- **Author:** [papersflow-ai](https://github.com/papersflow-ai)
- **Source:** [papersflow-ai/papersflow-skills](https://github.com/papersflow-ai/papersflow-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-papersflow-ai-papersflow-skills-deepscan-monitor
- Seller: https://agentstack.voostack.com/s/papersflow-ai
- 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%.