paper-argument-annotator
NewBuild 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".
Overview
论文论证批注阅读页
把一篇学术论文做成一个单文件、自包含的双栏批注 HTML,重点呈现论文的论证结构与逻辑层次。
运行时输入(不写进 skill,开工前向用户索取)
需要三项,缺任意一项就先问用户:
- 论文标题
- 课程 / 周次(用于顶部导航栏的副信息;若用户没有课程语境,可放期刊名或留空)
- 论文全文(粘贴或上传)
不要替用户编造论文内容;只对用户实际提供的文本进行标注。
输出
/mnt/user-data/outputs/ 下的单个 .html 文件,完全自包含:字体经 Google Fonts CDN 引入,其余 CSS/JS 全部内联,断网也能在本地打开。
五类高亮维度(颜色固定,不可更改)
| 维度 | 颜色 | 高亮底色 |
|---|---|---|
| 核心论点 / thesis | 黄 | #fff3a0 |
| 关键概念 / 术语 | 红 | #ffd6d6 |
| 实证证据 / 数据 | 蓝 | #cfe3ff |
| 让步 / 反驳处理 | 绿 | #cdeccd |
| 方法论说明 | 紫 | #e4d4f4 |
高亮是荧光笔式背景色,文字保持深色、始终可读。只标关键短语或句子,不要整段涂色——满屏高亮等于没有高亮。每处高亮用对应的 <mark class="..."> 类。
页面结构(自上而下)
- 顶部导航栏(深海军蓝):论文标题 + 课程/周次;右侧嵌入五色图例(颜色块 + 维度名)。
- 章节导航条(sticky):列出论文各节,点击锚点跳转;滚动时停靠在顶栏下方。
- 主体双栏:
- 左栏:论文原文,保留原文分段,按五类维度高亮,Lora 衬线字体。 - 右栏:逐段中文批注卡片,与左栏段落一一对应(同一逻辑行对齐)。
- 底部论证结构总览:见下。
右栏批注:每段卡片必含三要素
每个批注卡片对应左栏一个自然段,依次写:
- 段落功能 —— 如:引出问题 / 提供背景 / 提出论点 / 提供证据 / 反驳异议 / 过渡 / 总结。
- 逻辑角色 —— 该段在整体论证链中的位置(它支撑哪个主张?承接上文哪一步?为下文铺垫什么?)。
- 论证技巧或潜在漏洞 —— 值得注意的修辞/论证手法,或一处可质疑之处(如样本偏差、以偏概全、举证责任转移、相关当因果)。不必每段都挑刺,但发现弱点要点出。
批注用中文、简洁、就事论事;不复述原文,而是揭示原文“在做什么”。
底部论证结构总览
页面末尾给出整体复盘:
- •全文逻辑骨架:以「问题 → 论点 → 证据 → 反驳 → 结论」的链条概括,每环填入本文的实际内容。
- •作者核心主张(一句话版本):把全文压缩成一句。
- •论证最强处:一条,说明为何有力。
- •论证最弱处:一条,说明可被如何攻击。
设计规范
- •顶部导航栏:深海军蓝
#0d2438;纸张底色:米白#f6f1e7。 - •字体:正文/原文用 Lora(衬线);界面、导航、批注用 IBM Plex Sans。
- •批注卡片:左侧粗色边 + 浅背景;色边颜色可呼应该段主导的高亮维度。
- •章节导航条 sticky,当前节高亮。
- •响应式:桌面双栏;移动端(≤ 880px)折叠为单栏——每段批注移到对应原文段落的正下方,仍保留左色边卡片样式。
制作步骤
- 从
assets/template.html复制脚手架——它已实现导航栏、图例、sticky 章节条、双栏栅格、批注卡片、底部总览和移动端断点。不要从零写 CSS,改模板即可保证每篇产出一致。 - 填入标题与课程信息,按论文实际章节生成章节导航条与锚点。
- 把原文逐段放入左栏,给关键内容加
<mark>高亮。 - 为每段写右栏批注卡片(功能 / 逻辑角色 / 技巧或漏洞)。
- 填写底部论证结构总览。
- 先在工作目录生成,自检渲染无误后再复制到
/mnt/user-data/outputs/交付。
Install & Usage
mkdir -p .claude/skillsmkdir -p .claude/skills && curl -o .claude/skills/paper-argument-annotator.md https://raw.githubusercontent.com/feichovy/paper_annotation_skill/main/SKILL.md/paper-argument-annotatorSecurity Audits
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.