reading_easy

reading_easy is a file-first academic reading and research organization skill for Codex and Claude Code.

中文定位：reading_easy 是一个面向研究生、博士生、科研新人和跨学科研究者的学术阅读与科研知识管理 Skill。它帮助你把论文摘要、文献列表、阅读笔记、周报记录和 Zotero/Obsidian 元数据整理成结构化 Markdown 文件。

What It Does

• Decide whether a paper deserves 精读 / 速读 / 暂缓.
• Generate structured single-paper reading decisions and analysis.
• Build research topic maps around core questions, branch questions, method evolution, bottlenecks, open questions, and research gaps.
• Create Chinese paper digests from provided paper metadata or pasted titles and abstracts.
• Convert fragmented weekly notes into literature reading reports and research progress reports.
• Prepare Zotero-compatible metadata and Obsidian paper-note frontmatter.

File-first Output

reading_easy 默认生成 .md 文件，而不是在聊天框里输出长文。最终聊天回复只包含：

1. 已生成文件路径
2. 文件用途
3. 3-5 条内容摘要
4. 下一步建议

默认输出目录：

reading_easy_outputs/
  research_digests/
  paper_notes/
  topic_surveys/
  weekly_literature/
  weekly_progress/
  zotero_obsidian_notes/
  codex_prompts/
  academic_writing/

What It Does Not Do

• It does not fabricate citations, data, methods, experiments, results, or novelty claims.
• It does not pretend to read full text when only abstracts are provided.
• It does not implement live arXiv, PubMed, OpenAlex, Zotero, or Obsidian APIs.
• It does not replace scientific judgment, advisor feedback, peer review, or responsible research practice.

Folder Structure

reading-easy/
├── .codex-plugin/
│   └── plugin.json
├── skills/
│   └── reading-easy/
│       ├── SKILL.md
│       ├── agents/openai.yaml
│       └── references/
├── docs/
├── assets/promo/
├── scripts/
└── README.md

Install For Codex

Use reading-easy/ as a Codex plugin folder. The plugin manifest is:

.codex-plugin/plugin.json

The callable skill lives at:

skills/reading-easy/SKILL.md

Example invocation:

用 reading_easy 分析这篇论文摘要，判断精读/速读/暂缓。

Install For Claude Code

Copy the skill folder:

reading-easy/skills/reading-easy/

into your Claude Code skills directory, then call it as reading-easy or reading_easy.

Core Modules

Module	Use When
paper-reading-decision	You have one paper, abstract, or excerpt and need a reading decision.
research-topic-mapper	You have a topic or multiple papers and need a structured topic map or research gaps.
paper-digest-generator	You have paper entries and need a short Chinese digest.
weekly-research-reporter	You have weekly reading/progress notes and need a report.
zotero-obsidian-note-maker	You need Zotero metadata or Obsidian note structure.

Example Workflow

Paper Source / Manual Input
        -> Paper Digest
        -> Paper Reading Decision
        -> Research Topic Mapper
        -> Weekly Research Reporter
        -> Obsidian Knowledge Base
        -> Zotero Citation / Metadata Management

Screenshots

The promotional screenshots are in assets/promo:

• 01-workflow.png
• 02-paper-reading-decision.png
• 03-research-topic-mapper.png
• 04-obsidian-note.png

GitHub Publishing

See docs/github_upload_tutorial.md.

Xiaohongshu Post

See docs/xiaohongshu_post.md.

Acknowledgements

This project was inspired by the academic skill design ideas from chtc66/academic-skills.

reading_easy is independently redesigned as a file-first academic reading and research organization skill for Codex and Claude Code. The current project uses its own module names, output contracts, templates, and Zotero–Obsidian workflow design. It focuses on paper reading decisions, research topic mapping, paper digest generation, weekly research reporting, and Markdown-based knowledge organization.

Before public release, please check the license of the referenced project and ensure that attribution and reuse comply with its license terms.

致谢

本项目的 Skill 设计思路受到 chtc66/academic-skills 的启发。

reading_easy 是一个独立重新设计的 file-first 学术阅读与科研知识管理 Skill，面向 Codex 和 Claude Code 使用。本项目使用了重新命名的模块、独立的输出规范、模板结构和 Zotero–Obsidian 工作流设计，重点支持论文阅读决策、研究主题地图、论文速递生成、科研周报整理和 Markdown 知识库组织。

在正式公开发布前，请检查参考项目的 license，并确保 attribution 和使用方式符合其 license 要求。

License

MIT. If you publish this repository, keep the license notice and avoid using private paper notes or personal research data in public examples.

Star History