scholar-inbox-clip

Solid

Read all unread Scholar Inbox emails from Mac Mail.app (Scholar Alert Digests and Trending Papers), fetch each paper's AI overview from alphaXiv (or fall back to the raw paper), translate to the configured output language (default Traditional Chinese), apply color highlights, and create Heptabase cards. Use when the user asks to process Scholar Inbox papers, clip papers from alphaXiv, or update Heptabase with new research. Invoked with NO paper URL, it instead runs a BACKFILL maintenance pass: find existing alphaXiv cards whose Tasks property is empty (an automated run may have skipped semantic tagging), annotate them, and re-sync the affected comparison-overview cards. An explicit "re-audit" / 「重審 Tasks」 ask runs the RE-AUDIT pass instead: semantic review of already-set Tasks values, proposing mis-tag removals for user approval.

AI & Automation 3 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Scholar Inbox → Heptabase Clip Skill ## Agent(claude / codex) 本 skill 可由 Claude Code 或 Codex 駕駛(Codex 端:`research-cards@private-plugins` plugin 的 scholar-inbox-clip skill)。 差異:alphaXiv MCP 工具僅 Claude 有——Codex 駕駛時改用 run.py 內建的 HTTP 抓取 (`fetch_alphaxiv_*`)取得論文內容。cron/scripts 的文字生成呼叫依 config `agent` 分流(claude --print / codex exec),互動 session 一律由駕駛中的 agent 本人生成。 ## Backend(heptabase / obsidian / both) 讀 `~/.config/research-cards/config.json`(樣板:plugin 根目錄 `config.example.json`)。 `heptabase`/`both`(或無 config):原 heptabase CLI 路徑,行為不變(自動化流程安全)。 `obsidian`:卡片=vault `Papers/` 的 .md(frontmatter 存 arxiv_id/source_type/tasks), journal=每日筆記 `<date>.md`(資料夾由 `obsidian.journal.folder` 設定,空=vault 根),顏色標記=`<span style="color:…">`、 toggle=`- ⏵ `字首 bullet(plugin markdown 方言,Obsidian 可渲染、不可誤點)。`check-tasks` 的選項清單在 obsidian 模式改為「OVERVIEW_TASKS ∪ vault 既有 tasks 值」(無 tag database 可查)。 ## 互動模式的兩條硬規則(cron 以外的每一次 clip,任何 backend) 1. **卡片必須直接以教學式格式產出**(card-rewrite 的 8 點清單:一句話/為什麼〈config profile.reader〉該讀/0. 先備知識/教學式正文/中英並列/快速摘要/圖片/上色/Source)。 「baseline 翻譯卡+日後 retrofit」只是 cron(run.py 無人值守)的權宜——互動 clip 沒有理由產出半成品。 2. **圖片放置不要 shell 出 claude CLI**(巢狀呼叫在互動 session 內會失敗):先 `headings, figs = run.figure_candidates(cid, arxiv_id)` 看候選, 自行決定後 `run.insert_figures_into_card(cid, arxiv_id, placements=[...])`。 cron 路徑仍走 call_claude,失敗時自動降級為無圖並進 retry 記錄,不會中斷管線。 Automates the full pipeline: read digest emails → fetch alphaXiv AI overview per paper → translate to the output language → color-highl...

Details

Author
SungFeng-Huang
Repository
SungFeng-Huang/research-cards
Created
3 weeks ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Solid

card-rewrite

Rewrite a Heptabase paper card into the "teaching-style" format — written to onboard the reader configured at config profile.reader — assumed NOT an expert in that paper's subfield: a one-line essence + why-you-should-read framing, a 先備知識 glossary that defines the jargon in plain language, teaching prose that explains the WHY (not just the what), bilingual terms (English kept alongside Chinese), a filled-in 快速摘要, preserved figures, and re-applied colorization. Use when the user asks to rewrite / 重寫 / 教學式 / upgrade a paper card, or to retrofit existing cards in batches. The gold reference is the card configured at config `gold_cards.card_rewrite`(未設定時以本 skill 的 teaching_spec.md 為準).

3 Updated today
SungFeng-Huang
Data & Documents Listed

read-paper

精读并拆解学术论文(以 PDF 为主),自动适配论文类型(理论证明 / 实验方法 / 综述 / 系统)。把一篇或多篇论文整理成一套详细、可教学的分析条目(每个承重结果 / 方法 / 实验一个 markdown 文件)外加一份导航总览:含形式陈述或问题动机、大白话直觉、分步推导或实验解读、非平凡之处、以及它在全局里的角色;公式用规范 LaTeX,关系图用 mermaid、几何图用内联 SVG。当用户要求 读论文 / 解读 / 拆解 / 整理 / 分析 / 精读 / summarize / analyze / digest 一篇或多篇论文、PDF、或要把论文变成学习笔记时使用。

0 Updated 1 weeks ago
LuoHaomin
Data & Documents Listed

bilingual-paper-reader

英文論文的雙欄對照精讀工具。把 PDF 轉成逐段資料檔,由你逐段翻成貼切通順的學術中文,並用五色預先標出核心論點/創新點/方法/限制/可引用金句,再用一個可重複使用的離線 HTML 閱讀器左右對照閱讀;使用者可自己再畫螢光筆,標記存在瀏覽器可持久保存,並一鍵匯出成 Markdown 讀書筆記。閱讀器是一支、論文是資料檔,不是一篇論文一個檔。何時用:要精讀一篇英文期刊論文、想邊看邊對照中文、要標重點並留下筆記、想快速判斷這篇的貢獻與弱點在哪。觸發詞:論文翻譯、對照翻譯、雙語對照、中英對照、逐段翻譯、精讀論文、讀論文、英文論文看不懂、螢光筆、畫重點、標重點、讀書筆記、論文筆記、閱讀器、bilingual reader。與 literature-matrix-builder 劃界:那支管『一批文獻的橫向比較』(建庫、矩陣、APA7),本 skill 管『單篇論文的縱向精讀』;精讀完的判斷可回填進矩陣的綜整欄。與 text-analytics-architect 劃界:那支做規模化文字量化(語調、主題模型),本 skill 是人工精讀輔助,不做量化。

2 Updated 2 days ago
Nero1688