用途：在 Obsidian 本地库与 zergscholar 网页应用之间同步论文、草稿与知识条目。本地笔记是笔记与草稿的事实来源，zergscholar 保存协作者状态与论文规范元数据，关联通过笔记 frontmatter 的 zergscholar_id 跟踪。
主要能力：基于 Bearer Token 的 REST 认证；支持多账号（每个工作区一个 token，用 -a 覆盖默认账号）。命令包括 whoami、list-papers（可按已关联/未关联筛选）、push-paper、pull-paper、status、push-knowledge、push-draft、pull-draft、pull-all、push-folder、push-annotation，以及批量维护命令 enrich-all、enrich-metadata、backfill-pdfs、extract-text、pull-drafts。push-paper 读取 frontmatter 的 year、arxiv/arxiv_id、doi、authors，H1 作为标题，Abstract 或 Technical Synopsis 作为摘要，并自动从 Reading/pdfs/ 上传同名 PDF，可用 --pdf 覆盖。去重优先按 arXiv/DOI 查找，其次用已有 zergscholar_id 恢复，均无命中才新建论文；--force 不会创建重复行，仅跳过 already_linked 短路以重跑补充与 PDF 上传。
使用方式：先登录部署（默认 https://zergscholar.fly.dev），在 Settings → API Tokens 创建带 write 权限的 token（仅显示一次），再运行 python3 ~/.claude/skills/zergscholar/zergscholar_skill.py setup 交互配置 base URL、token、默认工作区与 Obsidian 库路径，写入 ~/.claude/skills/zergscholar/config.json。各命令形如 python3 ~/.claude/skills/zergscholar/zergscholar_skill.py <subcommand>，输出均为 JSON，成功退出码 0，一般错误 1，配置问题 2。push-folder 支持 --dry-run 预演且幂等。
适用场景：把本地论文笔记发布到工作区、从团队库拉取论文到本地、查找尚未推送的论文、把已关联笔记的 H2 段落作为知识条目推送、推送与拉取写作草稿、用工作区笔记批量初始化新库，以及批量修复元数据、缺失 PDF 与文本提取。
限制与注意：config.json 中的 token 等同工作区级会话凭据，应留在磁盘且不要提交；token 按工作区隔离，A 的写 token 无法访问 B；可在 <base_url>/app/settings → API Tokens 撤销或重新生成，失效后技能会返回 401，需重跑 setup。pdf_result.extractedTextChars/pageCount 由服务端异步填充，新上传时为 0/null 表示仍在排队。本资料未提供收费、价格与性能等其他信息。