Awesome Paper Skill
Use this skill when user asks for a full pipeline:
- 1. User gives a topic.
- Agent researches papers (multi-source, not arXiv-only).
- Agent builds/updates an Awesome-style
README.md. - Agent pushes changes to user GitHub repo.
Required Inputs
- -
topic (required) - INLINECODE2 (required)
- INLINECODE3 (required)
- INLINECODE4 (optional, default: keep current repo visibility)
- INLINECODE5 /
max_crossref / max_semantic (optional)
If owner/repo are omitted, use defaults from current workspace context or ask once.
Pipeline
1) Fetch papers (multi-source)
CODEBLOCK0
Policy:
- - Merge arXiv + Crossref + Semantic Scholar.
- Continue on partial source failures; report coverage gaps.
- De-duplicate by title/doi.
2) Build Awesome README
CODEBLOCK1
Formatting rules (strict):
- - English-only.
- One paper per bullet.
- If venue known: show
[Venue] line. - If venue unknown: do not print
[Preprint] line. - Keep arXiv badge line.
- Keep GitHub badge line only when valid repo exists.
- Do not include Website placeholders/badges.
- Date on its own line:
(YYYY-MM-DD).
3) Publish/update GitHub repo
CODEBLOCK2
If repo exists: update README and push.
If repo does not exist: create then push.
Quality Gates
Before final reply:
- - README renders.
- INLINECODE11 count matches entries.
- No Website placeholder links.
- No fake
Repo Not Found badges. - Repo push succeeded.
Deliverables to user
- - Brief summary (what changed)
- GitHub commit/repo URL
Awesome Paper Skill
当用户请求完整流程时使用此技能：
- 1. 用户提供主题。
- 智能体搜索论文（多源，不仅限于arXiv）。
- 智能体构建/更新Awesome风格的README.md。
- 智能体将更改推送到用户GitHub仓库。
必需输入
- - topic（必需）
- repoowner（必需）
- reponame（必需）
- visibility（可选，默认：保持当前仓库可见性）
- maxarxiv / maxcrossref / max_semantic（可选）
如果省略owner/repo，则使用当前工作区上下文中的默认值，或询问一次。
流程
1) 获取论文（多源）
bash
python3 skills/awesome-paper-skill/scripts/fetch_papers.py \
--topic \
--max-arxiv 60 \
--max-crossref 60 \
--max-semantic 60 \
--out /tmp/research_papers.json
策略：
- - 合并arXiv + Crossref + Semantic Scholar。
- 部分源失败时继续执行；报告覆盖缺口。
- 按标题/DOI去重。
2) 构建Awesome README
bash
python3 skills/awesome-paper-skill/scripts/buildawesomereadme.py \
--topic \
--input /tmp/research_papers.json \
--output /tmp/README.md
格式规则（严格）：
- - 仅限英文。
- 每篇论文一个项目符号。
- 如果已知会议/期刊：显示[Venue]行。
- 如果未知会议/期刊：不打印[Preprint]行。
- 保留arXiv徽章行。
- 仅当存在有效仓库时保留GitHub徽章行。
- 不包含网站占位符/徽章。
- 日期单独一行：(YYYY-MM-DD)。
3) 发布/更新GitHub仓库
bash
python3 skills/awesome-paper-skill/scripts/publish_repo.py \
--owner \
--name \
--readme /tmp/README.md \
--visibility private
如果仓库存在：更新README并推送。
如果仓库不存在：创建后推送。
质量检查
在最终回复前：
- - README渲染正常。
- Total papers计数与条目匹配。
- 无网站占位符链接。
- 无虚假Repo Not Found徽章。
- 仓库推送成功。
交付给用户的内容
- - 简要摘要（变更内容）
- GitHub提交/仓库URL
