BeClaude

paper-argument-annotator

New
2GitHub TrendingGeneralby feichovy

Build a single self-contained two-column annotated HTML reading guide for an academic paper. The left column shows the original text color-coded by argument dimension (thesis / key terms / evidence / counterargument-handling / methodology); the right column gives paragraph-by-paragraph Chinese commentary; the page ends with an argument-structure overview. Use this whenever the user wants to annotate, close-read, break down, or visualize the argumentation or logical structure of an academic paper, journal article, book chapter, or assigned reading — including requests phrased as "论文批注", "精读这篇论文", "拆解论证结构", "做成阅读批注页", "帮我分析这篇论文的论证", "annotate this paper", or "make a reading guide" — even when the user does not say the word "skill" or "HTML".

First seen 6/2/2026

Overview

论文论证批注阅读页

把一篇学术论文做成一个单文件、自包含的双栏批注 HTML,重点呈现论文的论证结构与逻辑层次。

运行时输入(不写进 skill,开工前向用户索取)

需要三项,缺任意一项就先问用户:

  1. 论文标题
  2. 课程 / 周次(用于顶部导航栏的副信息;若用户没有课程语境,可放期刊名或留空)
  3. 论文全文(粘贴或上传)

不要替用户编造论文内容;只对用户实际提供的文本进行标注。

输出

/mnt/user-data/outputs/ 下的单个 .html 文件,完全自包含:字体经 Google Fonts CDN 引入,其余 CSS/JS 全部内联,断网也能在本地打开。

五类高亮维度(颜色固定,不可更改)

维度颜色高亮底色
核心论点 / thesis#fff3a0
关键概念 / 术语#ffd6d6
实证证据 / 数据#cfe3ff
让步 / 反驳处理绿#cdeccd
方法论说明#e4d4f4

高亮是荧光笔式背景色,文字保持深色、始终可读。只标关键短语或句子,不要整段涂色——满屏高亮等于没有高亮。每处高亮用对应的 <mark class="..."> 类。

页面结构(自上而下)

  1. 顶部导航栏(深海军蓝):论文标题 + 课程/周次;右侧嵌入五色图例(颜色块 + 维度名)。
  2. 章节导航条(sticky):列出论文各节,点击锚点跳转;滚动时停靠在顶栏下方。
  3. 主体双栏

- 左栏:论文原文,保留原文分段,按五类维度高亮,Lora 衬线字体。 - 右栏:逐段中文批注卡片,与左栏段落一一对应(同一逻辑行对齐)。

  1. 底部论证结构总览:见下。

右栏批注:每段卡片必含三要素

每个批注卡片对应左栏一个自然段,依次写:

  1. 段落功能 —— 如:引出问题 / 提供背景 / 提出论点 / 提供证据 / 反驳异议 / 过渡 / 总结。
  2. 逻辑角色 —— 该段在整体论证链中的位置(它支撑哪个主张?承接上文哪一步?为下文铺垫什么?)。
  3. 论证技巧或潜在漏洞 —— 值得注意的修辞/论证手法,或一处可质疑之处(如样本偏差、以偏概全、举证责任转移、相关当因果)。不必每段都挑刺,但发现弱点要点出。

批注用中文、简洁、就事论事;不复述原文,而是揭示原文“在做什么”。

底部论证结构总览

页面末尾给出整体复盘:

  • 全文逻辑骨架:以「问题 → 论点 → 证据 → 反驳 → 结论」的链条概括,每环填入本文的实际内容。
  • 作者核心主张(一句话版本):把全文压缩成一句。
  • 论证最强处:一条,说明为何有力。
  • 论证最弱处:一条,说明可被如何攻击。

设计规范

  • 顶部导航栏:深海军蓝 #0d2438;纸张底色:米白 #f6f1e7
  • 字体:正文/原文用 Lora(衬线);界面、导航、批注用 IBM Plex Sans
  • 批注卡片:左侧粗色边 + 浅背景;色边颜色可呼应该段主导的高亮维度。
  • 章节导航条 sticky,当前节高亮。
  • 响应式:桌面双栏;移动端(≤ 880px)折叠为单栏——每段批注移到对应原文段落的正下方,仍保留左色边卡片样式。

制作步骤

  1. assets/template.html 复制脚手架——它已实现导航栏、图例、sticky 章节条、双栏栅格、批注卡片、底部总览和移动端断点。不要从零写 CSS,改模板即可保证每篇产出一致。
  2. 填入标题与课程信息,按论文实际章节生成章节导航条与锚点。
  3. 把原文逐段放入左栏,给关键内容加 <mark> 高亮。
  4. 为每段写右栏批注卡片(功能 / 逻辑角色 / 技巧或漏洞)。
  5. 填写底部论证结构总览。
  6. 先在工作目录生成,自检渲染无误后再复制到 /mnt/user-data/outputs/ 交付。

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/paper-argument-annotator.md https://raw.githubusercontent.com/feichovy/paper_annotation_skill/main/SKILL.md
3
Invoke in Claude Code
/paper-argument-annotator
View source on GitHub

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is paper-argument-annotator?

Build a single self-contained two-column annotated HTML reading guide for an academic paper. The left column shows the original text color-coded by argument dimension (thesis / key terms / evidence / counterargument-handling / methodology); the right column gives paragraph-by-paragraph Chinese commentary; the page ends with an argument-structure overview. Use this whenever the user wants to annotate, close-read, break down, or visualize the argumentation or logical structure of an academic paper, journal article, book chapter, or assigned reading — including requests phrased as "论文批注", "精读这篇论文", "拆解论证结构", "做成阅读批注页", "帮我分析这篇论文的论证", "annotate this paper", or "make a reading guide" — even when the user does not say the word "skill" or "HTML".

How to install paper-argument-annotator?

To install paper-argument-annotator: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/paper-argument-annotator.md https://raw.githubusercontent.com/feichovy/paper_annotation_skill/main/SKILL.md. Finally, /paper-argument-annotator in Claude Code.

What is paper-argument-annotator best for?

paper-argument-annotator is a skill categorized under General. Created by feichovy.