From d981e98239ceddb40b7e739d643b2e9febbb9211 Mon Sep 17 00:00:00 2001
From: xr843 <xianren843@protonmail.com>
Date: Sun, 3 May 2026 21:09:57 +0800
Subject: [PATCH] docs: add npm publish badges + global-install instructions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Now that v0.4.0 / v0.5.0 / v0.6.0 are live on the npm registry, surface
that in the README:

- npm version + monthly downloads badges (zh + en READMEs)
- new "全局安装" / "Global install" snippet alongside the existing NPX
  recipe — covers users who'd rather skip the npx prefix or work offline
- CHANGELOG Unreleased entry noting the registry publish

No code changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md |  1 +
 README.md    | 13 ++++++++++++-
 README_EN.md | 13 ++++++++++++-
 3 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2fb8ad5..ee6eac0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ Sections marked **Ethics** track changes to `ETHICS.md`, content licensing, or b
 ## [Unreleased]
 
 ### Added
+- npm publish: `master-skill` package live on registry — `npm install -g master-skill` or `npx master-skill` now serves all three published versions (0.4.0 / 0.5.0 / 0.6.0). README badges added for npm version + monthly downloads.
 - `ETHICS.md` — AI transparency, copyright tier (A/B/C/D), religious boundary, dual-track content license, takedown channel.
 - `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md` — community infrastructure.
 - `.github/ISSUE_TEMPLATE/` — bug report, feature request, new-master proposal, boundary-violation.
diff --git a/README.md b/README.md
index 9a455b3..15c9e35 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/v/master-skill.svg?label=npm&color=cb3837" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/dm/master-skill.svg?color=cb3837" alt="npm downloads"></a>
   <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
   <img src="https://img.shields.io/badge/Python-3.9+-green.svg" alt="Python 3.9+">
   <img src="https://img.shields.io/badge/Claude%20Code-Skill-purple.svg" alt="Claude Code Skill">
@@ -124,7 +126,7 @@
 
 ### 安装
 
-**NPX 一键安装（推荐）**
+**NPX 一键安装（推荐，无需常驻）**
 
 ```bash
 # 安装指定祖师
@@ -137,6 +139,15 @@ npx master-skill install --all
 npx master-skill list
 ```
 
+**全局安装（频繁使用 / 离线场景）**
+
+```bash
+npm install -g master-skill            # 一次性装到 $PATH
+master-skill install master-zhiyi      # 之后省掉 npx，直接调
+master-skill list
+npm update -g master-skill             # 升到下一个 minor / patch
+```
+
 **Claude Code（插件方式）**
 
 ```bash
diff --git a/README_EN.md b/README_EN.md
index f754d68..c5d8b6c 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -9,6 +9,8 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/v/master-skill.svg?label=npm&color=cb3837" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/master-skill"><img src="https://img.shields.io/npm/dm/master-skill.svg?color=cb3837" alt="npm downloads"></a>
   <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
   <img src="https://img.shields.io/badge/Python-3.9+-green.svg" alt="Python 3.9+">
   <img src="https://img.shields.io/badge/Claude%20Code-Skill-purple.svg" alt="Claude Code Skill">
@@ -125,13 +127,22 @@ This project is built out of respect for Buddhist traditions. All content is gen
 
 ### Installation
 
-**NPX (recommended)**
+**NPX (recommended, no global state)**
 
 ```bash
 npx master-skill install --all    # Install all 15 masters
 npx master-skill list             # List available masters
 ```
 
+**Global install (frequent use / offline-friendly)**
+
+```bash
+npm install -g master-skill            # Adds the binary to $PATH
+master-skill install master-zhiyi      # No more npx prefix
+master-skill list
+npm update -g master-skill             # Pull next minor / patch
+```
+
 **Claude Code**
 
 ```bash