Install
$ agentstack add skill-jason-0409-g-scriptorium-research-to-paper-scope ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →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:
- Entry mode — Rewrite Existing (improve a draft they already have) or Build From Materials (draft from notes,
data, figures, partial drafts).
- Angle / research question — the specific claim or question, not the broad topic.
- Scope boundaries — what's in and what's explicitly out (this prevents an unfocused review).
- Target scene —
journal/conference/report/review/competition; this sets the structure. - Target journal / venue — which one they're aiming at. If unsure, suggest 2-3 fits for the angle.
- Research depth —
flash(3 scene exemplars + 3 recent in-field papers + the venue's requirements) orpro
(6 + 6).
- Word count / length — their target, or the venue's limit once known.
- Output language — English or Chinese.
- 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
- Source: Jason-0409-G/scriptorium
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.