Skip to content
Back to search

scholar-skill

An OpenClaw skill for academic reading, knowledge linking, reflection, and knowledge evolution in Obsidian.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eesjgong--scholar-skill/badge.svg)](/listings/eesjgong--scholar-skill)

HTML

<a href="/listings/eesjgong--scholar-skill"><img src="/api/listings/eesjgong--scholar-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick Start

If you want the simplest path, clone the repository locally, open that workspace in OpenClaw, and let the agent finish the setup for you.

Example flow:

git clone https://github.com/EESJGong/scholar-skill.git
cd scholar-skill

Then ask the OpenClaw agent to finish the install, for example:

Please install this repository as an OpenClaw skill, use the Chinese package, and configure it for my Obsidian vault at /your/Obsidian/Vault.

or:

Please install this repository as an OpenClaw skill, use the English package, and configure it for my Obsidian vault at /your/Obsidian/Vault.

The agent can then place the repository into the correct `skills` directory, pick `zh-CN/` or `en/`, and run the matching `configure.py` with `--vault-path`.

That is the complete quick-start path.

Manual Install and Detailed Setup

If you prefer to install and configure everything yourself, follow the detailed flow below.

Step 0: Choose your language package first

This repository ships as two parallel packages:

- `en/`: English workflow, docs, and templates - `zh-CN/`: Simplified Chinese workflow, docs, and templates

After cloning the repository, always start from the package you want to use, then run that package's setup script with an explicit vault path:

# English package
python en/scripts/configure.py auto --vault-path "/your/Obsidian/Vault"

# Simplified Chinese package
python zh-CN/scripts/configure.py auto --vault-path "/你的/Obsidian/Vault"

Passing `--vault-path` from the start avoids accidentally configuring the wrong vault and keeps templates separated under `9-Templates/en/` or `9-Templates/zh-CN/`.

Option 1: Clone into the shared skills directory

Use this if you want ScholarSkill to be available across OpenClaw workspaces on the same machine.

mkdir -p ~/.openclaw/skills
git clone https://github.com/EESJGong/scholar-skill.git ~/.openclaw/skills/scholar-skill

openclaw skills info scholar-skill
openclaw skills check

Option 2: Clone or copy into a specific workspace

Use this if you want ScholarSkill to exist only inside one OpenClaw workspace.

mkdir -p <your-workspace>/skills
git clone https://github.com/EESJGong/scholar-skill.git <your-workspace>/skills/scholar-skill

Or, if you already downloaded the folder:

cp -R scholar-skill <your-workspace>/skills/

Then verify it:

cd <your-workspace>
openclaw skills list --eligible
openclaw skills info scholar-skill
openclaw skills check

Install dependency skills with ClawHub

`clawhub install` installs into `./skills` under your current working directory, so run it from the location where you want the dependencies to live.

For shared installation:

cd ~/.openclaw
clawhub install obsidian-direct
clawhub install obsidian-cli
clawhub install arxiv-watcher
clawhub install academic-research-hub
clawhub install tavily
clawhub install pdf
clawhub install durable-task-runner

For workspace-scoped installation:

cd <your-workspace>
clawhub install obsidian-direct
clawhub install obsidian-cli
clawhub install arxiv-watcher
clawhub install academic-research-hub
clawhub install tavily
clawhub install pdf
clawhub install durable-task-runner

After the manual install is complete, start a new OpenClaw session so the new skills are picked up.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ScholarSkill Repository Entry
  2. This repository ships two language-specific variants of the same skill package.
  3. Choose one:
  4. - English package: [en/SKILL.md](en/SKILL.md)
  5. - Simplified Chinese package: [zh-CN/SKILL.md](zh-CN/SKILL.md)
  6. Shared repository files:
  7. - [requirements.txt](requirements.txt)
  8. - [LICENSE](LICENSE)
  9. - [CONTRIBUTING.md](CONTRIBUTING.md)
  10. - [CHANGELOG.md](CHANGELOG.md)
  11. If you are using this repository in GitHub, start with the language-specific package directory.
README.md · README · 244 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [English](README.md) | [简体中文](README.zh-CN.md)
  2. # ScholarSkill
  3. > This project is currently in the testing stage. Star it, try it, and feel very welcome to share suggestions and feedback.
  4. ![ScholarSkill teaser](assets/teaser-owl-final.png)
  5. <p align="center">
  6. <strong>Build a living research knowledge system in Obsidian.</strong><br/>
  7. An OpenClaw skill for structured paper reading, knowledge linking, cognitive revision, and critical thinking.
  8. </p>
  9. <p align="center">
  10. <a href="en/SKILL.md">English Skill Docs</a> ·
  11. <a href="zh-CN/SKILL.md">中文技能说明</a> ·
  12. <a href="#installation">Installation</a> ·
  13. <a href="#core-strengths">Core Strengths</a>
  14. </p>
  15. <p align="center">
  16. <img alt="OpenClaw Skill" src="https://img.shields.io/badge/OpenClaw-Skill-1f2937?style=flat-square">
  17. <img alt="Obsidian Workflow" src="https://img.shields.io/badge/Obsidian-Knowledge%20Workflow-6d28d9?style=flat-square">
  18. <img alt="Bilingual Repo" src="https://img.shields.io/badge/Docs-English%20%2F%20中文-0f766e?style=flat-square">
  19. <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-b45309?style=flat-square">
  20. </p>
  21. ScholarSkill is an Obsidian-centered academic reading workflow for OpenClaw. It is designed for more than paper collection and note dumping: the goal is to help an agent read papers, extract durable knowledge, connect new ideas to an existing knowledge base, and keep that knowledge system evolving over time.
  22. ## Why It Feels Different
  23. Many academic assistants stop at search, summarization, or note capture. ScholarSkill is designed around the next step: turning paper reading into an evolving knowledge workflow inside Obsidian.
  24. - It turns reading into structured notes instead of one-off summaries
  25. - It connects new papers to existing notes and knowledge maps
  26. - It supports revising older understanding as new evidence appears
  27. - It encourages comparison, verification, and critical reflection
  28. - It is built for a research workflow that keeps getting stronger over time
  29. ## Installation
  30. ### Quick Start
  31. If you want the simplest path, clone the repository locally, open that workspace in OpenClaw, and let the agent finish the setup for you.
  32. Example flow:
  33. ```bash
  34. git clone https://github.com/EESJGong/scholar-skill.git
  35. cd scholar-skill
  36. ```
  37. Then ask the OpenClaw agent to finish the install, for example:
  38. ```text
  39. Please install this repository as an OpenClaw skill, use the Chinese package, and configure it for my Obsidian vault at /your/Obsidian/Vault.
  40. ```
  41. or:
  42. ```text
  43. Please install this repository as an OpenClaw skill, use the English package, and configure it for my Obsidian vault at /your/Obsidian/Vault.
  44. ```
  45. The agent can then place the repository into the correct `skills` directory, pick `zh-CN/` or `en/`, and run the matching `configure.py` with `--vault-path`.
  46. That is the complete quick-start path.
  47. ### Manual Install and Detailed Setup
  48. If you prefer to install and configure everything yourself, follow the detailed flow below.
  49. ### Step 0: Choose your language package first
  50. This repository ships as two parallel packages:
  51. - `en/`: English workflow, docs, and templates
  52. - `zh-CN/`: Simplified Chinese workflow, docs, and templates
  53. After cloning the repository, always start from the package you want to use, then run that package's setup script with an explicit vault path:
  54. ```bash
  55. # English package
  56. python en/scripts/configure.py auto --vault-path "/your/Obsidian/Vault"
  57. # Simplified Chinese package
  58. python zh-CN/scripts/configure.py auto --vault-path "/你的/Obsidian/Vault"
  59. ```
  60. Passing `--vault-path` from the start avoids accidentally configuring the wrong vault and keeps templates separated under `9-Templates/en/` or `9-Templates/zh-CN/`.
  61. ### Option 1: Clone into the shared skills directory
  62. Use this if you want ScholarSkill to be available across OpenClaw workspaces on the same machine.
  63. ```bash
  64. mkdir -p ~/.openclaw/skills
  65. git clone https://github.com/EESJGong/scholar-skill.git ~/.openclaw/skills/scholar-skill
  66. openclaw skills info scholar-skill
  67. openclaw skills check
  68. ```
  69. ### Option 2: Clone or copy into a specific workspace
  70. Use this if you want ScholarSkill to exist only inside one OpenClaw workspace.
  71. ```bash
  72. mkdir -p <your-workspace>/skills
  73. git clone https://github.com/EESJGong/scholar-skill.git <your-workspace>/skills/scholar-skill
  74. ```
  75. Or, if you already downloaded the folder:
  76. ```bash
  77. cp -R scholar-skill <your-workspace>/skills/
  78. ```
  79. Then verify it:
  80. ```bash
  81. cd <your-workspace>
  82. openclaw skills list --eligible
  83. openclaw skills info scholar-skill
  84. openclaw skills check
  85. ```
  86. ### Install dependency skills with ClawHub
  87. `clawhub install` installs into `./skills` under your current working directory, so run it from the location where you want the dependencies to live.
  88. For shared installation:
  89. ```bash
  90. cd ~/.openclaw
  91. clawhub install obsidian-direct
  92. clawhub install obsidian-cli
  93. clawhub install arxiv-watcher
  94. clawhub install academic-research-hub
  95. clawhub install tavily
  96. clawhub install pdf
  97. clawhub install durable-task-runner
  98. ```
  99. For workspace-scoped installation:
  100. ```bash
  101. cd <your-workspace>
  102. clawhub install obsidian-direct
  103. clawhub install obsidian-cli
  104. clawhub install arxiv-watcher
  105. clawhub install academic-research-hub
  106. clawhub install tavily
  107. clawhub install pdf
  108. clawhub install durable-task-runner
  109. ```
  110. After the manual install is complete, start a new OpenClaw session so the new skills are picked up.
  111. ## Core Strengths
  112. ### Structured Notes
  113. ScholarSkill turns a paper into more than a summary paragraph. It helps produce organized reading notes, extracted insights, reusable knowledge units, and a clearer record of what the paper actually contributes.
  114. Instead of leaving the result as a one-off chat response, the workflow is designed to create notes that can be revisited, expanded, and linked later inside Obsidian.
  115. ### Knowledge Network
  116. ScholarSkill treats every new paper as part of a larger research context. New notes can be linked to existing topics, prior papers, domain concepts, and maps of content, so the vault grows as a network rather than a folder of isolated documents.
  117. This makes it easier to see how ideas relate, where a new paper fits, and which parts of an existing knowledge base should be updated or expanded.
  118. ### Cognitive Update
  119. ScholarSkill is built around the idea that research understanding should evolve. When a new paper introduces stronger evidence, a better framing, or a contradiction to earlier notes, the workflow encourages revising older understanding instead of simply appending more information.
  120. That makes the knowledge base progressively sharper over time, rather than larger but harder to trust.
  121. ### Critical Thinking
  122. ScholarSkill is not meant to passively record papers. It supports comparing claims, checking evidence, spotting assumptions, and asking whether a conclusion is actually well supported.
  123. The goal is to make the reading process more evaluative and research-oriented, so the resulting knowledge system reflects judgment rather than just accumulation.
  124. ## What It Supports
  125. ### Literature Reading and Note Building
  126. Use ScholarSkill to turn individual papers into structured notes that are easier to search, compare, and reuse later.
  127. ### Memory Extraction for Long-Term Knowledge
  128. Capture semantic, episodic, and procedural memories so the system preserves not only what a paper says, but also what was learned from reading it and what can be reused in future work.
  129. ### Obsidian-Native Knowledge Growth
  130. Keep the output inside an Obsidian vault, where notes, concept pages, and MOCs can evolve together instead of being trapped in disconnected chat logs.
  131. ### Ongoing Research Understanding
  132. Support workflows where reading a new paper can refine topic understanding, reveal gaps, or trigger updates to older notes and interpretations.
  133. ### Verification-Oriented Research Workflows
  134. Fit research processes that care about comparison, evidence checking, and synthesis instead of stopping at summarization.
  135. ## Repository Structure
  136. This repository is split into two parallel language packages:
  137. - [en/](en/README.md): complete English package
  138. - [zh-CN/](zh-CN/README.md): complete Simplified Chinese package
  139. ```text
  140. scholar-skill/
  141. ├── README.md
  142. ├── README.zh-CN.md
  143. ├── SKILL.md # repository entry
  144. ├── requirements.txt
  145. ├── en/ # full English package
  146. └── zh-CN/ # full Simplified Chinese package
  147. ```
  148. ## Getting Started
  149. Start from the language-specific package you want to use:
  150. - English package entry: [en/SKILL.md](en/SKILL.md)
  151. - Chinese package entry: [zh-CN/SKILL.md](zh-CN/SKILL.md)
  152. Shared repository files remain at the root:
  153. - [LICENSE](LICENSE)
  154. - [CONTRIBUTING.md](CONTRIBUTING.md)
  155. - [CHANGELOG.md](CHANGELOG.md)
  156. - [requirements.txt](requirements.txt)
  157. ## Suggested Reading Order
  158. 1. Read the package-level [README](en/README.md) or [中文版说明](zh-CN/README.md)
  159. 2. Open the package-level [SKILL.md](en/SKILL.md) or [中文版 SKILL.md](zh-CN/SKILL.md)
  160. 3. Run the setup guide in the corresponding package
  161. 4. Install the required dependency skills and connect your Obsidian vault

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.