Paper Query Skill

OpenCode Agent Skill — Multi-database academic paper search with CCF + CAS-JCR + SCI venue ranking, Chinese title translation, and bilingual abstracts.

Features

• 7+ databases searched in parallel: arXiv, Semantic Scholar, DBLP, PubMed, IEEE Xplore, ACM DL, OpenAlex
• Published-only filter — excludes unpublished preprints, keeps only journal/conference papers
• Venue tier annotation — CCF (A/B/C) + CAS-JCR (Q1-Q4) + SCI (Q1-Q4) for 100+ top venues across 10 CS subfields
• Chinese title translation — auto-translate English titles to academic Chinese
• Bilingual summaries — 2-3 sentence EN + CN abstract summaries
• Direct links — arXiv, DOI, Semantic Scholar links for every paper
• Auto-save — results saved as Markdown to papers/ directory
• Smart fallback — when IEEE/ACM APIs are blocked, papers still appear via Semantic Scholar and OpenAlex (meta-search engines)

Installation

Method 1: Global (all projects)

# Linux / macOS / WSL
mkdir -p ~/.config/opencode/skills/paper-query
cp SKILL.md ~/.config/opencode/skills/paper-query/

Windows PowerShell:

New-Item -ItemType Directory -Path "$env:USERPROFILE\.config\opencode\skills\paper-query" -Force
Copy-Item SKILL.md -Destination "$env:USERPROFILE\.config\opencode\skills\paper-query\"

Method 2: Per-project

mkdir -p .opencode/skills/paper-query
cp SKILL.md .opencode/skills/paper-query/

Verify

Run opencode and the skill will appear automatically in available skills. The agent loads it on-demand when you ask about papers.

Configuration

Copy paper-config.example.json to your project root as paper-config.json:

cp paper-config.example.json /path/to/your/project/paper-config.json

Edit the file to set your preferences:

Field	Description	Default
user.name	Your name/alias	""
user.institution	University/organization	""
api_keys.semantic_scholar	Free API key for higher rate limits	""
api_keys.ieee	IEEE Xplore API key (optional)	""
preferences.databases	Databases to search	["arxiv", "semantic_scholar", "dblp", "pubmed", "ieee", "acm"]
preferences.min_venue_tier.ccf	Minimum CCF tier (A/B/C/None)	"C"
preferences.min_venue_tier.cas_jcr	Minimum CAS-JCR quartile	"Q3"
preferences.min_venue_tier.sci	Minimum SCI quartile	"Q3"
preferences.max_results	Max papers per query	30
preferences.sort_by	Sort: relevance/citations/year	"relevance"
preferences.year_range	null = last 3 years, or [2023, 2026]	null
preferences.output.save_to_file	Auto-save to papers/	true

Usage

Once installed and configured, ask about papers in any OpenCode session:

/paper-query graph neural networks
/paper-query transformer attention --year 2024-2026
/paper-query federated learning privacy --count 20

The skill will:

1. Read paper-config.json for your settings
2. Search all configured databases in parallel
3. Deduplicate results by DOI/title
4. Filter to published papers only
5. Annotate CCF + SCI + CAS-JCR tiers
6. Translate titles to Chinese
7. Generate bilingual summaries
8. Save to papers/query_<timestamp>.md

Data Sources

Database	Coverage	Auth Required	Status
Semantic Scholar	All fields	Free API key (optional)	Primary
OpenAlex	All fields, open access	None	Primary
arXiv	CS, Math, Physics preprints	None	Primary (rate-limited: 3s/req)
DBLP	CS bibliography	None	Unstable (may 500)
PubMed	Biomedical	None	Stable
IEEE Xplore	Engineering conferences	API key	Skip without key
ACM Digital Library	CS conferences	Institutional	Skip without access
Google Scholar	All fields	None	Blocked often

Important: IEEE and ACM papers are still retrieved via Semantic Scholar and OpenAlex (meta-search engines) even when their direct APIs are unavailable. No data is lost.

Getting API Keys

Semantic Scholar (recommended — free)

1. Visit https://www.semanticscholar.org/product/api
2. Click "Get an API Key"
3. Fill out the form (free, instant approval)
4. Add to paper-config.json: "api_keys": { "semantic_scholar": "your-key" }

IEEE Xplore (optional — institutional)

1. Visit https://developer.ieee.org/
2. Register with institutional email or IEEE membership
3. Request API access
4. Add to paper-config.json: "api_keys": { "ieee": "your-key" }

Without an IEEE key, IEEE papers are still fully covered via Semantic Scholar and OpenAlex.

Venue Tier Database

The skill includes a built-in ranking database covering 100+ venues across 10 CS subfields:

Field	Top Venues (CCF-A)
AI/ML	NeurIPS, ICML, AAAI, IJCAI, TPAMI, JMLR
Computer Vision	CVPR, ICCV, IJCV, TIP
NLP	ACL, EMNLP, CL, TACL
Systems	OSDI, SOSP, ASPLOS, EuroSys, TOCS
Networks	SIGCOMM, NSDI, MobiCom, INFOCOM, TON, JSAC
Databases	SIGMOD, VLDB, ICDE, TKDE
Security	IEEE S&P, ACM CCS, USENIX Security, NDSS
Software Engineering	ICSE, FSE, ASE, ISSTA, TSE, TOSEM
HCI	CHI, UIST, CSCW, TOCHI
Theory	STOC, FOCS, SODA, JACM, SICOMP

Full tables with CCF + SCI + CAS-JCR tiers are embedded in SKILL.md.

Output Format

# 论文查询结果: "graph neural networks"
**查询时间**: 2026-05-11 15:00 | **数据库**: Semantic Scholar, OpenAlex, arXiv | **共 15 条**

## 概览
- 检索关键词: graph neural networks
- 年份范围: 2023–2026
- 最低等级: CCF-C / SCI-Q3 / CAS-Q3

| # | 标题 | 作者 | 年份 | 会议/期刊 | 等级 | 引用 | 链接 |
|---|------|------|------|----------|------|------|------|
| 1 | Graph Attention Networks | Veličković et al. | 2018 | ICLR | 🏆CCF-A | 45k+ | [arXiv] [DOI] |

---

### #1 Graph Attention Networks
**中文标题**: 图注意力网络
**等级**: 🏆 CCF-A*
**概述 (EN)**: Introduces graph attention networks (GATs), which leverage masked self-attention layers...
**概述 (CN)**: 提出了图注意力网络(GAT)，利用掩码自注意力层来处理图结构数据...
**链接**: [arXiv:1710.10903] | [DOI] | [Semantic Scholar]

License

MIT

Author

Paper Query Skill for OpenCode Agent