# Research To Paper Scope

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-jason-0409-g-scriptorium-research-to-paper-scope`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jason-0409-G](https://agentstack.voostack.com/s/jason-0409-g)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jason-0409-G](https://github.com/Jason-0409-G)
- **Source:** https://github.com/Jason-0409-G/scriptorium/tree/main/skills/research-to-paper-scope

## Install

```sh
agentstack add skill-jason-0409-g-scriptorium-research-to-paper-scope
```

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

## About

# Scope — decide the direction (research first, then discuss)

The point of this stage is to avoid the most expensive mistake in academic writing: searching and drafting in
the wrong direction. So the order is deliberate — **understand the field before proposing anything, and let the
user steer every decision.** Do not jump to a title or start collecting references until the direction is locked.

## Step 1 — Understand the field first (don't propose yet)

Take the user's broad direction and read enough to speak about it credibly. Use the bundled search
(`../research-to-paper-curate/scripts/search_papers.py`) or web search to find a small, high-signal set, scaled to
the research depth (Step 2): **flash** ≈ 3 recent/seminal in-field works plus a couple of target-scene exemplars;
**pro** ≈ 6 + 6 (default to flash for this first pass, then read more if the user picks pro). This is orientation
reading, not the full library search (that's CURATE's job) — you want the lay of the land: what's established,
what's contested, where the open questions are, and how the best papers frame the topic.

Read enough to answer, for yourself: what are the live debates, what gaps keep getting named, and what framings
do strong papers use? If you cannot answer these, read more before continuing. Proposing directions from a thin
understanding is how scopes go wrong.

Tell the user briefly what you learned (a few sentences, with the key sources), so they see the basis for the
options you're about to offer.

## Step 2 — Propose directions, one decision at a time

Now offer **2-3 concrete angles / research questions**, each with its trade-offs and your recommendation, grounded
in what you just read (e.g., "Angle A occupies the gap that Reviews X and Y both flag, but needs data you may not
have; Angle B is safer and still novel because…"). Lead with the one you'd pick and say why.

Ask about **one decision at a time** — do not dump a questionnaire. Wait for the user's choice before moving to the
next decision. The decisions to lock, in order:

1. **Entry mode** — Rewrite Existing (improve a draft they already have) or Build From Materials (draft from notes,
   data, figures, partial drafts).
2. **Angle / research question** — the specific claim or question, not the broad topic.
3. **Scope boundaries** — what's in and what's explicitly out (this prevents an unfocused review).
4. **Target scene** — `journal` / `conference` / `report` / `review` / `competition`; this sets the structure.
5. **Target journal / venue** — which one they're aiming at. If unsure, suggest 2-3 fits for the angle.
6. **Research depth** — `flash` (3 scene exemplars + 3 recent in-field papers + the venue's requirements) or `pro`
   (6 + 6).
7. **Word count / length** — their target, or the venue's limit once known.
8. **Output language** — English or Chinese.
9. **Core themes / sub-topics** — the 3-6 threads the paper will develop; these become the literature categories
   in CURATE and the section spine in writing.

For each, present options or a recommendation, let them decide, then confirm back what was chosen before the next
question. If a choice contradicts an earlier one, surface it rather than silently proceeding.

## Step 3 — Once the journal is set, look up its requirements

As soon as the target journal is confirmed, go find that journal's actual author guidance — do not rely on memory,
journal requirements change and vary a lot. Use web search/fetch to pull the journal's *Guide for Authors* / *Author
Instructions* and capture what will constrain the writing:

- aims & scope (does the angle fit? flag early if it's a stretch),
- accepted article types (does "review" / "report" / "research article" match what the user wants?),
- length limits (word count, figure/table caps, reference caps),
- required structure (IMRaD? structured abstract? specific sections),
- reference/citation style.

Summarize these back to the user and reconcile them with the earlier decisions (e.g., if their word count exceeds
the journal's limit, raise it now). If the angle doesn't fit the journal's scope, say so before any drafting.

## Step 4 — Write the direction brief

Capture everything in **`scope_brief.md`** so the later stages don't re-litigate decisions:

```
# Scope brief: 
Entry mode: 
Target scene: 
Research question / angle: ...
Scope:
  - in:  ...
  - out: ...
Target journal / venue: 
  Article type: ...   Length limit: ...   Structure: ...   Citation style: ...   Scope fit: ...
Research depth: 
Target word count: ...
Output language: 
Core themes (→ literature categories): 1) ... 2) ... 3) ...
Key sources read for orientation: 
Open questions still to resolve: ...
```

Hand this brief to `research-to-paper-curate` (its themes become the search categories) and to `research-to-paper-write`
(the angle becomes the motivation, the journal requirements become hard constraints). The brief is a contract: later
stages follow it, and any change to direction comes back through this stage, not improvised downstream.

## Principles

- Research before you propose; propose before you ask; confirm before you proceed.
- One decision per question. The user steers; you inform and recommend.
- Journal requirements are looked up live, never recalled, and reconciled with the user's choices immediately.

## Source & license

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

- **Author:** [Jason-0409-G](https://github.com/Jason-0409-G)
- **Source:** [Jason-0409-G/scriptorium](https://github.com/Jason-0409-G/scriptorium)
- **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-jason-0409-g-scriptorium-research-to-paper-scope
- Seller: https://agentstack.voostack.com/s/jason-0409-g
- 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%.
