diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..4b086e4
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,16 @@
+{
+  "name": "deeppapernote",
+  "description": "Official marketplace for the DeepPaperNote paper-reading skills.",
+  "owner": {
+    "name": "917Dhj",
+    "url": "https://github.com/917Dhj"
+  },
+  "plugins": [
+    {
+      "name": "deeppapernote",
+      "source": "./",
+      "description": "Academic paper reading and Obsidian note generation skills for building a research WIKI.",
+      "category": "research"
+    }
+  ]
+}
diff --git a/AGENTS.md b/AGENTS.md
index 5da624b..d777f55 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -46,7 +46,7 @@ The repository is layered as follows:
 
 - `skills/deeppapernote/SKILL.md` is the canonical workflow definition and the skill entrypoint for both Claude Code and other agents
 - `CLAUDE.md` provides Claude Code project-level guidance and includes `AGENTS.md` via `@AGENTS.md`
-- `.claude-plugin/plugin.json` identifies the Claude Code plugin
+- `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` identify the Claude Code plugin and its marketplace entry
 - `.codex-plugin/plugin.json` identifies the Codex plugin
 - `skills/deeppapernote/references/` stores durable workflow and writing guidance
 - `skills/deeppapernote/scripts/` implements the deterministic pipeline and support utilities
diff --git a/CHANGELOG.md b/CHANGELOG.md
index be809e7..957868e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,10 @@ Add an entry here when the project meaningfully changes for users, for example:
 
 ## Unreleased
 
+### Added
+
+- DeepPaperNote can now be installed as a Claude Code plugin from the repository's own marketplace, with `claude plugin marketplace add 917Dhj/DeepPaperNote`. The skills CLI (`npx skills add`) remains the agent-neutral route.
+
 ## v2.3.1
 
 ### Improved
diff --git a/README.md b/README.md
index 394acd5..ca83d90 100644
--- a/README.md
+++ b/README.md
@@ -55,11 +55,23 @@ News lists only the three most recent user-facing milestones. See the [changelog
 
 ### 1. Install the plugin
 
+**Claude Code** — install from the plugin marketplace:
+
+```bash
+claude plugin marketplace add 917Dhj/DeepPaperNote
+```
+
+```bash
+claude plugin install deeppapernote@deeppapernote
+```
+
+**Any agent** — install with the skills CLI:
+
 ```bash
 npx skills add 917Dhj/DeepPaperNote
 ```
 
-The installer lets you choose which skills to install and which agents should receive them. For most users, start with `deeppapernote`; add `paper-glossary` only if you want reusable terminology notes.
+Both routes install the same skills. The plugin route brings both `deeppapernote` and `paper-glossary`; the skills CLI installer lets you choose which skills to install and which agents should receive them. For most users, start with `deeppapernote`; add `paper-glossary` only if you want reusable terminology notes.
 
 ### 2. Install the core PDF dependency
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index d75d7ed..b0e0a05 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -55,11 +55,23 @@ DeepPaperNote 是一个专注于**一次精读一篇论文**的 Agent Skill。
 
 ### 1. 安装插件
 
+**Claude Code** —— 通过插件市场安装：
+
+```bash
+claude plugin marketplace add 917Dhj/DeepPaperNote
+```
+
+```bash
+claude plugin install deeppapernote@deeppapernote
+```
+
+**任意 Agent** —— 通过 skills CLI 安装：
+
 ```bash
 npx skills add 917Dhj/DeepPaperNote
 ```
 
-安装程序会让你选择需要安装的 skill，以及要安装到哪些 Agent。大多数用户可以先选择 `deeppapernote`；只有需要可复用术语笔记时，再选择 `paper-glossary`。
+两条路径安装的是同一组 skill。插件路径会一并装上 `deeppapernote` 与 `paper-glossary`；skills CLI 安装程序则让你选择需要安装的 skill，以及要安装到哪些 Agent。大多数用户可以先选择 `deeppapernote`；只有需要可复用术语笔记时，再选择 `paper-glossary`。
 
 ### 2. 安装核心 PDF 依赖