From 1d454c2dd69f722808021d9261888c7a47af7b02 Mon Sep 17 00:00:00 2001
From: Minsu Lee <minsu.lee@pleaseai.dev>
Date: Mon, 14 Sep 2026 10:22:23 +0900
Subject: [PATCH 1/2] docs: document the Claude Code plugin install route

The README offered one install route and said the plugin one had no
marketplace entry. It now documents both: `/plugin marketplace add` plus
`/plugin install`, the `claude plugin` equivalents, and the
`.claude/settings.json` form for pinning it per project.

Renames the plugin manifest to `spring`. `claude plugin validate` warns that
`@pleaseai/spring` is not kebab-case and that the Claude.ai marketplace sync
requires kebab-case, so the old name could not be listed. The npm package keeps
its scoped name; only the plugin identifier changes.
---
 .claude-plugin/plugin.json |  2 +-
 README.md                  | 52 ++++++++++++++++++++++++++++++++++----
 2 files changed, 48 insertions(+), 6 deletions(-)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 4e6d8c0..7fb32fa 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,5 +1,5 @@
 {
-  "name": "@pleaseai/spring",
+  "name": "spring",
   "version": "0.0.0",
   "description": "Detect Spring versions from build files and install version-matched reference docs as Claude Code skills.",
   "keywords": [
diff --git a/README.md b/README.md
index 74e7bc7..a58833e 100644
--- a/README.md
+++ b/README.md
@@ -12,17 +12,59 @@ Two scripts and one skill are implemented: build-file detection, documentation r
 
 ## Install
 
+### As a Claude Code plugin
+
+Register the marketplace once, then install:
+
+```
+/plugin marketplace add pleaseai/claude-code-plugins
+/plugin install spring@pleaseai
+```
+
+Or from the command line, outside a session:
+
+```bash
+claude plugin marketplace add pleaseai/claude-code-plugins
+claude plugin install spring@pleaseai
+```
+
+To pin it per project instead, commit the equivalent to `.claude/settings.json`:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "pleaseai": {
+      "source": { "source": "github", "repo": "pleaseai/claude-code-plugins" }
+    }
+  },
+  "enabledPlugins": { "spring@pleaseai": true }
+}
+```
+
+### As a standalone skill
+
 ```bash
 npx skills add pleaseai/spring-plugin
 ```
 
 This installs the `spring-docs` skill for whichever agents the
-[`skills` CLI](https://github.com/vercel-labs/skills) detects. It copies only the
-skill directory, which is why the scripts it runs are committed as
-dependency-free bundles inside it.
+[`skills` CLI](https://github.com/vercel-labs/skills) detects — Claude Code,
+Cursor, Codex and others. It copies only the skill directory and runs no
+dependency install, which is why the scripts it runs are committed as
+dependency-free `.mjs` bundles inside it.
 
-The same directory also loads as a Claude Code plugin. There is no marketplace
-entry yet, so that route is the symlink under [Development](#development).
+### Which one
+
+| | Plugin | `npx skills` |
+|---|---|---|
+| Agents | Claude Code only | every agent the `skills` CLI supports |
+| Updates | `/plugin update spring@pleaseai` | re-run `npx skills add` |
+
+Both install the same `spring-docs` skill, and it behaves identically in either:
+the skill addresses its scripts through `${CLAUDE_SKILL_DIR}` and runs the
+committed `.mjs` bundles with `node`, so it needs nothing above its own
+directory. Installing both is redundant rather than harmful — the skill writes
+nothing into your project either way.
 
 ## What it does
 

From 5f35397c6a864c22c6d71afb75350db977b60670 Mon Sep 17 00:00:00 2001
From: Minsu Lee <minsu.lee@pleaseai.dev>
Date: Mon, 14 Sep 2026 10:44:52 +0900
Subject: [PATCH 2/2] docs: capitalize the install comparison table cells

Applies a gemini-code-assist review finding on #15. The `npx skills` column
started lowercase while the `Plugin` column beside it started uppercase.
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a58833e..7e40b0b 100644
--- a/README.md
+++ b/README.md
@@ -57,8 +57,8 @@ dependency-free `.mjs` bundles inside it.
 
 | | Plugin | `npx skills` |
 |---|---|---|
-| Agents | Claude Code only | every agent the `skills` CLI supports |
-| Updates | `/plugin update spring@pleaseai` | re-run `npx skills add` |
+| Agents | Claude Code only | Every agent the `skills` CLI supports |
+| Updates | `/plugin update spring@pleaseai` | Re-run `npx skills add` |
 
 Both install the same `spring-docs` skill, and it behaves identically in either:
 the skill addresses its scripts through `${CLAUDE_SKILL_DIR}` and runs the