alphalab-ustc/researchclaw/paper-scout
Claude Code and agent skill by alphalab-ustc/researchclaw
- community
Checking that the SKILL.md file is still in the repository.
Discover and recommend latest arXiv papers matching user research interests. Use when user says: 推荐今日论文, paper scout, 每日论文, daily papers, paper recommendation.
Install
npx vskill@latest install alphalab-ustc/researchclaw/paper-scoutSKILL.md
Paper Scout — Daily Paper Discovery
⚙️ Step 0 — Read the Research Profile (Always First)
Before running any capability, load the user's research profile.
Location: ~/.openclaw/workspace/research-claw-config.md
If this file does not exist, use these defaults silently and mention at the end:
💡 想定制推荐兴趣?试试说「更新我的研究画像」
Config fields reference:
research_direction— free-text description of the user's research focusseed_papers— list of arXiv IDs the user considers gold-standard referenceskeywords— interest topics used for Paper Scout search querieswhitelist_authors— researcher names to prioritize in recommendationslearned_preferences.accept— keywords/topics user has explicitly likedlearned_preferences.reject— keywords/topics user has skipped or disliked
Goal: Find today's top arXiv papers matching user interests. Output Top 5–10 with relevance scoring.
Triggers: 推荐今日论文 · 每日论文 · paper scout · daily cron job
Step 1 — Build search queries
From the loaded profile, extract keywords and construct arXiv query URLs:
- Replace spaces in keywords with
+(e.g.,large+language+models) - Run 2–4 queries covering different interest areas
- If the user has
seed_papers, also fetch their metadata via:
`` https://export.arxiv.org/abs/{ARXIV_ID} `` Use these to calibrate what "relevant" means (topics, methods, problem framing).
Step 2 — Fetch and parse
Use web_fetch for each query URL. Parse the XML Atom response:
Filter: Only keep papers published within the last 3 days (compare <published> to today's date in Asia/Shanghai timezone). If fewer than 5 papers remain, extend to 7 days and note it.
Step 3 — Score and rank
Score each paper 1–5 on relevance:
| Signal | Score Boost | |
|---|---|---|
| Title contains exact keyword from user profile | +2 | |
| Abstract contains ≥3 keyword matches | +1.5 | |
Author in whitelist_authors | +2 | |
| Paper cites or builds on seed paper | +1.5 | |
| Novel contribution words: "propose", "novel", "outperform", "state-of-the-art", "benchmark" | +0.5 | |
| Survey/review signal: "survey", "overview", "analysis of existing" | −1 | |
Topic in learned_preferences.accept | +1 | |
Topic in learned_preferences.reject | −2 |
Sort descending by score. Keep Top 5 (or Top 10 if user asks for more).
Step 4 — Format and output
Step 5 — Auto-learn from feedback
If the user reacts to a recommended paper with:
"不错"/"这个好"/"有意思"/"精读"→ extract keywords from that paper's title/abstract, add tolearned_preferences.acceptin config"skip"/"没意思"/"不相关"→ extract keywords, add tolearned_preferences.reject
Update ~/.openclaw/workspace/research-claw-config.md immediately.
Cron setup
If user wants daily delivery:
- Time: 9:00 AM (Asia/Shanghai)
- Prompt:
推荐今日论文 - Channel: user's preferred channel (Discord, Telegram, etc.)
⚠️ Error Handling
| Error | Handling | |
|---|---|---|
| arXiv API returns empty results | Retry once with broader query; if still empty, note "arXiv API temporarily unavailable" | |
| PDF tool times out | Fall back to abstract-only mode; note [Abstract only — PDF timeout] in the note | |
| PDF tool returns error for a paper | Try fetching https://ar5iv.labs.arxiv.org/html/{ARXIV_ID} as HTML fallback | |
| Config file missing | Use defaults silently; add a note at end: "💡 想定制?说「更新我的研究画像」" | |
| Reading list JSON missing or malformed | Start fresh with an empty list; inform user: "未找到现有列表,已新建空列表" | |
| Template file not found | Report the expected path and ask user to check installation | |
| No papers in last 3 days | Extend to 7 days, note it: "(近3天论文较少,已扩展至7天)" | |
| Fewer than 3 read papers for Idea Generator | Proceed anyway, but note the limitation | |
| User provides PDF/DOI instead of arXiv | Try to extract arXiv ID from DOI or search arXiv by title |
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/paper-scout/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/alphalab-ustc/researchclaw/paper-scout)