Annotate Paper banner
VanLinLin VanLinLin

Annotate Paper

Development community

Description

An agent skill that turns an academic paper into a reading companion: a plain-language opening, the real forward pass, annotated original text, and what you can take away — what to reuse, what you'd have to decide yourself, which numbers to trust. Markdown, not HTML.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

English繁體中文

annotate-paper

**Turn a paper into a reading companion.**
Not a summary. Not a review. What you can take away, and what you must not build on.

[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-SKILL.md-black)](https://agentskills.io) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Obsidian](https://img.shields.io/badge/Obsidian-first-7c3aed)](https://obsidian.md) [![output](https://img.shields.io/badge/output-Markdown-1f8b4c)]()


An [agent skill](https://agentskills.io) that reads an academic paper the way you would if you had a week — and writes down what you would have wanted to remember.

[!TIP] **Best paired with [Obsidian](https://obsidian.md)** (free). Obsidian is a notes app that stores everything as plain Markdown files in a folder on your machine — that folder is called a **vault**. The skill's output is just Markdown, so it opens anywhere, but Obsidian is where the figures embed live from the PDF, the cross-references become real links, and the colour coding shows up.

A **summary** throws away the argument and keeps the conclusion. A **review** produces a list of defects for someone else to act on. This produces neither. It produces the thing you actually open again six months later: **what this method really does, what is worth stealing from it, what you would have to decide for yourself to build it, and which of its numbers you can trust.**

![Anatomy of the note this skill produces](docs/anatomy.svg)


Quick start

npx skills add VanLinLin/annotate-paper        # 1. install
pip install pymupdf                            # 2. the only hard dependency
cp assets/annotate.css /.obsidian/snippets/annotate.css   # 3. styling (Obsidian)

Then just ask:

annotate this paper: `papers/attention-is-all-you-need.pdf`


What you get