neo-skill 0.1.12 → 0.1.14

package/README.md

@@ -2,13 +2,37 @@
 
 一个确定性的 **skill-creator** 仓库。
 
-**GitHub**: https://github.com/liuminxin45/neo-skill
+**GitHub**: https://github.com/liuminxin45/neo-skill  
+**npm**: https://www.npmjs.com/package/neo-skill
 
-## 使用方式
+## 安装
+
+```bash
+# 通过 npm 安装（推荐）
+npm install -g neo-skill
+
+# 或通过 pip 安装
+pip install neo-skill
+```
 
 **前置依赖**：需要安装 Python 3.8+
 
-### 直接运行 Python 模块
+## 使用方式
+
+### 命令行工具（安装后）
+
+```bash
+# 初始化技能
+omni-skill init --ai claude
+
+# 生成技能输出
+skill-creator generate skills/skill-name/skillspec.json
+
+# 验证技能
+skill-creator validate skills/skill-name/skillspec.json
+```
+
+### 直接运行 Python 模块（开发模式）
 
 ```bash
 # 初始化技能
@@ -51,30 +75,30 @@ python -m skill_creator.cli validate skills/skill-name/skillspec.json
 **初始化技能文件**
 ```bash
 # 初始化指定 AI 助手的技能文件
-python -m omni_skill.cli init --ai claude
-python -m omni_skill.cli init --ai windsurf
-python -m omni_skill.cli init --ai all  # 初始化所有支持的 AI 助手
+omni-skill init --ai claude
+omni-skill init --ai windsurf
+omni-skill init --ai all  # 初始化所有支持的 AI 助手
 
 # 更新（基于上次 init 的配置）
-python -m omni_skill.cli update
+omni-skill update
 ```
 
 **生成和验证技能**
 ```bash
 # 生成技能输出
-python -m skill_creator.cli generate skills/skill-name/skillspec.json
+skill-creator generate skills/skill-name/skillspec.json
 
 # 验证技能
-python -m skill_creator.cli validate skills/skill-name/skillspec.json
+skill-creator validate skills/skill-name/skillspec.json
 
 # 打包 Claude 技能
-python -m skill_creator.cli package --target claude --skill skill-name
+skill-creator package --target claude --skill skill-name
 ```
 
 **在其他项目中使用**
 将 neo-skill 仓库克隆到你的项目中（例如 `vendor/neo-skill/`），然后：
 1. 设置 PYTHONPATH：`export PYTHONPATH=$PWD/vendor/neo-skill/src:$PYTHONPATH`
-2. 运行命令：`python -m omni_skill.cli init --ai claude`
+2. 运行命令：`omni-skill init --ai claude`
 
 **支持的 AI 助手：**
 claude, cursor, windsurf, antigravity, copilot, kiro, codex, qoder, roocode, gemini, trae, opencode, continue, all

package/bin/omni-skill.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+
+function buildEnv(pkgRoot) {
+  const env = { ...process.env };
+  const srcPath = path.join(pkgRoot, "src");
+  const key = process.platform === "win32" ? "PYTHONPATH" : "PYTHONPATH";
+  const sep = process.platform === "win32" ? ";" : ":";
+  env[key] = env[key] ? `${srcPath}${sep}${env[key]}` : srcPath;
+  return env;
+}
+
+function spawnPython(cmd, args, env) {
+  return spawn(cmd, args, { stdio: "inherit", env });
+}
+
+function main() {
+  const pkgRoot = path.resolve(__dirname, "..");
+  const env = buildEnv(pkgRoot);
+  const pyArgs = ["-m", "omni_skill.cli", ...process.argv.slice(2)];
+
+  // Try python first; if not found on Windows, try py.
+  let child = spawnPython("python", pyArgs, env);
+
+  child.on("error", (err) => {
+    if (process.platform === "win32") {
+      const child2 = spawnPython("py", pyArgs, env);
+      child2.on("error", () => {
+        console.error("neo-skill: Python not found. Please install Python 3.8+ and ensure 'python' (or 'py') is on PATH.");
+        process.exit(127);
+      });
+      child2.on("exit", (code) => process.exit(code ?? 1));
+      return;
+    }
+
+    console.error("neo-skill: Python not found. Please install Python 3.8+ and ensure 'python' is on PATH.");
+    process.exit(127);
+  });
+
+  child.on("exit", (code) => process.exit(code ?? 1));
+}
+
+main();

package/bin/skill-creator.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+
+function buildEnv(pkgRoot) {
+  const env = { ...process.env };
+  const srcPath = path.join(pkgRoot, "src");
+  const sep = process.platform === "win32" ? ";" : ":";
+  env.PYTHONPATH = env.PYTHONPATH ? `${srcPath}${sep}${env.PYTHONPATH}` : srcPath;
+  return env;
+}
+
+function spawnPython(cmd, args, env) {
+  return spawn(cmd, args, { stdio: "inherit", env });
+}
+
+function main() {
+  const pkgRoot = path.resolve(__dirname, "..");
+  const env = buildEnv(pkgRoot);
+  const pyArgs = ["-m", "skill_creator.cli", ...process.argv.slice(2)];
+
+  let child = spawnPython("python", pyArgs, env);
+
+  child.on("error", () => {
+    if (process.platform === "win32") {
+      const child2 = spawnPython("py", pyArgs, env);
+      child2.on("error", () => {
+        console.error("neo-skill: Python not found. Please install Python 3.8+ and ensure 'python' (or 'py') is on PATH.");
+        process.exit(127);
+      });
+      child2.on("exit", (code) => process.exit(code ?? 1));
+      return;
+    }
+
+    console.error("neo-skill: Python not found. Please install Python 3.8+ and ensure 'python' is on PATH.");
+    process.exit(127);
+  });
+
+  child.on("exit", (code) => process.exit(code ?? 1));
+}
+
+main();

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "neo-skill",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "A multi-assistant skill generator (Claude/Windsurf/Cursor/GitHub Skills) driven by a canonical SkillSpec.",
   "license": "MIT",
+  "bin": {
+    "omni-skill": "bin/omni-skill.js",
+    "skill-creator": "bin/skill-creator.js"
+  },
   "files": [
+    "bin/**",
     "src/**",
     "skills/**",
     ".shared/**",
@@ -11,7 +16,8 @@
     ".windsurf/**",
     ".cursor/**",
     ".github/skills/**",
-    "README.md"
+    "README.md",
+    "pyproject.toml"
   ],
   "scripts": {},
   "engines": {

package/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=56"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "neo-skill"
+dynamic = ["version"]
+description = "A multi-assistant skill generator (Claude/Windsurf/Cursor/GitHub Skills) driven by a canonical SkillSpec."
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "skill-creator"}]
+
+[project.scripts]
+omni-skill = "omni_skill.cli:main"
+skill-creator = "skill_creator.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "skill_creator.__version__"}
+