From 843c2ef12978b1d69c9641a953b3939f20c5b501 Mon Sep 17 00:00:00 2001
From: dingdingcar <1054263492@qq.com>
Date: Sun, 27 Sep 2026 17:04:11 +0800
Subject: [PATCH] fix: add plugin marketplace manifest so the plugin can be
 installed

The repository shipped .claude-plugin/plugin.json but no
.claude-plugin/marketplace.json, so `claude plugin marketplace add
917Dhj/DeepPaperNote` failed with "Marketplace file not found". The
marketplace manifest existed until it was removed in e49fe61 and was never
restored when plugin.json was re-added in 1afbfc3.

Adding the manifest makes the repository installable as a Claude Code plugin
while keeping the existing `npx skills add` route working for any agent. The
plugin entry deliberately omits `version` so plugin.json stays the single
version source, avoiding the drift the previous entry had.

Also document both install routes in the READMEs, note the manifest in
AGENTS.md, and record the new install path in the changelog.

Verified: `claude plugin validate . --strict` exits 0 with no errors or
warnings, a local marketplace add + install loads both skills, and
`python3 -m pytest -q` passes (923 passed, 1 skipped).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .claude-plugin/marketplace.json | 16 ++++++++++++++++
 AGENTS.md                       |  2 +-
 CHANGELOG.md                    |  4 ++++
 README.md                       | 14 +++++++++++++-
 README.zh-CN.md                 | 14 +++++++++++++-
 5 files changed, 47 insertions(+), 3 deletions(-)
 create mode 100644 .claude-plugin/marketplace.json

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 依赖