@catcuts-skills/hello-world 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Skill NPM Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# Hello World Skill
+
+简单的 Hello World 示例技能，用于验证 Claude Code 技能安装是否成功。
+
+## 项目简介
+
+这是一个入门级的 Claude Code 技能示例，旨在帮助新用户：
+
+- 验证技能系统是否正常工作
+- 了解技能的基本结构和安装流程
+- 检查开发环境配置（Node.js、npm）
+
+## 功能特性
+
+- **欢迎信息**：显示友好的欢迎消息
+- **环境检查**：自动检测并显示 Node.js 和 npm 版本
+- **路径验证**：确认技能文件已正确安装
+- **使用示例**：提供下一步学习建议
+
+## 安装方法
+
+### 快速安装
+
+从 npm 安装包时会自动注册 skill 到 Opencode、Claude Code、Codex、Cursor 及其他 [19 个工具](https://github.com/vercel-labs/add-skill?tab=readme-ov-file#available-agents)。感谢 [Vercel 开源的 add-skill](https://github.com/vercel-labs/add-skill) 🌹
+
+```bash
+# 全局安装（推荐）
+npm install -g @catcuts-skills/hello-world
+
+# 项目级安装
+npm install @catcuts-skills/hello-world
+```
+
+### 本地开发安装
+
+如果正在开发本 skill，可以使用 npm scripts 手动安装：
+
+```bash
+# 全局安装
+npm run install:global
+
+# 项目级安装
+npm run install:local
+```
+
+### 手动安装
+
+如果自动安装失败，可以手动运行：
+
+```bash
+# 全局安装
+npx add-skill . -a claude-code -g -y
+
+# 项目级安装
+npx add-skill . -a claude-code -y
+```
+
+**安装范围说明**:
+
+- **全局**: 安装到用户目录 `~/.claude/skills/hello-world`，所有项目可用
+- **项目级**: 安装到项目目录 `.claude/skills/hello-world`，仅当前项目可用
+
+### 测试安装
+
+运行测试以验证安装配置（不会实际安装）：
+
+```bash
+npm test
+```
+
+### 卸载
+
+```bash
+# 全局卸载
+npm uninstall -g @catcuts-skills/hello-world
+
+# 项目级卸载
+npm uninstall @catcuts-skills/hello-world
+```
+
+卸载时会自动清理 skill 文件。
+
+## 使用示例
+
+安装完成后，在 Claude Code 中输入：
+
+```
+hello-world
+```
+
+**预期输出**：
+
+```
+✨ Hello World Skill 已成功安装！
+
+这是你的第一个 Claude Code 技能。让我们验证一下环境配置是否正确。
+
+环境信息：
+Node.js 版本: v20.x.x
+npm 版本: 10.x.x
+当前工作目录: /your/current/path
+当前日期时间: 2026-01-26 10:30:00
+
+✓ 技能文件已正确安装
+
+🎉 恭喜！你的技能系统运行正常。
+
+下一步建议：
+1. 探索更多技能：访问 https://github.com/catcuts/agent-skills
+2. 创建自定义技能：参考本技能的结构创建你自己的技能
+3. 了解更多 Claude Code 功能：查看官方文档
+
+技术信息：
+- 技能名称：hello-world
+- 版本：1.0.0
+- 作者：catcuts
+```
+
+## 验证安装成功
+
+安装成功的标志：
+
+1. **文件存在**：检查技能文件是否已安装
+
+    ```bash
+    # 全局安装
+    ls ~/.claude/skills/hello-world/SKILL.md
+
+    # 项目级安装
+    ls .claude/skills/hello-world/SKILL.md
+    ```
+
+2. **Claude Code 识别**：在 Claude Code 中输入 `/skills` 应该能看到 `hello-world` 技能
+
+3. **功能正常**：输入 `hello-world` 能正确显示欢迎信息和环境信息
+
+## 技术细节
+
+### 安装原理
+
+本技能使用 [Vercel 开源的 add-skill](https://github.com/vercel-labs/add-skill) 工具进行安装管理，支持 Opencode、Claude Code、Codex、Cursor 及其他 [19 个工具](https://github.com/vercel-labs/add-skill?tab=readme-ov-file#available-agents)。
+
+1. `package.json` 中的 `postinstall` 钩子自动运行安装脚本
+2. 安装脚本调用 `add-skill` 将 `SKILL.md` 复制到目标目录
+3. Claude Code 自动检测并加载技能
+
+### 安装路径
+
+**全局安装**:
+
+- 实际存储: `~/.agents/skills/hello-world/`
+- Claude Code 链接: `~/.claude/skills/hello-world/` (符号链接)
+
+**项目级安装**:
+
+- 实际存储: `.agents/skills/hello-world/`
+- Claude Code 链接: `.claude/skills/hello-world/` (符号链接)
+
+### 项目结构
+
+```
+skills/hello-world/
+├── package.json              # NPM 包配置
+├── SKILL.md                  # 技能定义文件
+├── README.md                 # 使用文档
+├── LICENSE                   # MIT 许可证
+├── .gitignore                # Git 忽略规则
+└── scripts/
+    ├── install-skill.js      # 安装脚本
+    └── uninstall-skill.js    # 卸载脚本
+```
+
+## 系统要求
+
+- Node.js >= 18.0.0
+- npm >= 9.0.0
+- Claude Code CLI
+
+## 下一步学习建议
+
+1. **探索更多技能**
+    - 访问 [agent-skills 仓库](https://github.com/catcuts/agent-skills) 查看更多技能示例
+    - 尝试 `handover` 技能学习跨会话工作交接
+
+2. **创建自定义技能**
+    - 参考 `SKILL.md` 的 YAML frontmatter 格式
+    - 学习如何使用 `allowed-tools` 声明需要的工具
+    - 编写清晰的技能指令
+
+3. **深入学习 Claude Code**
+    - 阅读 [Claude Code 官方文档](https://claude.com/claude-code)
+    - 了解技能开发最佳实践
+    - 参与社区讨论
+
+## 开发
+
+本技能基于 [agent-skill-npm-boilerplate](https://github.com/catcuts/agent-skill-npm-boilerplate) 开发。
+
+## 许可证
+
+MIT License - 详见 [LICENSE](LICENSE) 文件

package/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: hello-world
+description: 简单的 Hello World 示例技能，用于验证技能安装是否成功。显示欢迎信息、环境信息和使用示例。
+allowed-tools: Bash
+version: 1.0.0
+---
+
+# Hello World Skill
+
+欢迎使用 Hello World Skill！这是一个简单的示例技能，用于验证 Claude Code 技能系统是否正常工作。
+
+## 任务指令
+
+当被调用时，执行以下步骤：
+
+1. **显示欢迎信息**
+
+    ```
+    ✨ Hello World Skill 已成功安装！
+
+    这是你的第一个 Claude Code 技能。让我们验证一下环境配置是否正确。
+    ```
+
+2. **收集环境信息**
+
+    使用 `Bash` 工具执行以下命令：
+    - `node --version` - 显示 Node.js 版本
+    - `npm --version` - 显示 npm 版本
+    - `pwd` - 显示当前工作目录
+    - `date` - 显示当前日期时间
+
+3. **验证安装路径**
+
+    检查 skill 文件是否已正确安装：
+    - 全局安装：`~/.claude/skills/hello-world/SKILL.md`
+    - 项目级安装：`.claude/skills/hello-world/SKILL.md`
+
+    使用 Bash 执行：
+
+    ```bash
+    ls -la ~/.claude/skills/hello-world/SKILL.md 2>/dev/null || ls -la .claude/skills/hello-world/SKILL.md 2>/dev/null
+    ```
+
+    如果文件存在，显示：
+
+    ```
+    ✓ 技能文件已正确安装
+    ```
+
+4. **显示下一步建议**
+
+    ```
+    🎉 恭喜！你的技能系统运行正常。
+
+    下一步建议：
+    1. 探索更多技能：访问 https://github.com/catcuts/agent-skills
+    2. 创建自定义技能：参考本技能的结构创建你自己的技能
+    3. 了解更多 Claude Code 功能：查看官方文档
+
+    技术信息：
+    - 技能名称：hello-world
+    - 版本：1.0.0
+    - 作者：catcuts
+    ```

package/package.json

@@ -0,0 +1,42 @@
+{
+    "name": "@catcuts-skills/hello-world",
+    "version": "1.0.3",
+    "description": "简单的 Hello World 示例技能，用于验证技能安装是否成功。显示欢迎信息、环境信息和使用示例。",
+    "main": "index.js",
+    "scripts": {
+        "postinstall": "node scripts/install-skill.js",
+        "preuninstall": "node scripts/uninstall-skill.js",
+        "test": "node scripts/install-skill.js --dry-run",
+        "install:global": "node scripts/install-skill.js --global",
+        "install:local": "node scripts/install-skill.js --local",
+        "lint": "echo 'Add your linting commands here'"
+    },
+    "files": [
+        "SKILL.md",
+        "scripts/"
+    ],
+    "optionalDependencies": {
+        "skills": "^1.1.2"
+    },
+    "keywords": [
+        "claude-code",
+        "skill",
+        "hello-world",
+        "getting-started",
+        "environment-check"
+    ],
+    "author": "catcuts",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/catcuts/agent-skills.git",
+        "directory": "skills/hello-world"
+    },
+    "bugs": {
+        "url": "https://github.com/catcuts/agent-skills/issues"
+    },
+    "homepage": "https://github.com/catcuts/agent-skills/tree/main/skills/hello-world#readme",
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}

package/scripts/install-skill.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+/**
+ * Hello World Skill 安装脚本
+ * 使用 skills 将 skill 安装到 Claude Code
+ *
+ * 命令行参数 (推荐):
+ * --dry-run: 测试模式,只显示将要执行的命令,不实际安装
+ * --global: 强制全局安装
+ * --local: 强制项目级安装
+ *
+ * 环境变量 (备用):
+ * - SKILL_SCOPE: 安装范围,可选值: GLOBAL(全局) 或 LOCAL(项目级),默认: GLOBAL
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { printUsageGuide } = require('./usage-guide');
+
+// 获取包根目录
+const packageRoot = path.resolve(__dirname, '..');
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const dryRun = args.includes('--dry-run');
+const forceGlobal = args.includes('--global');
+const forceLocal = args.includes('--local');
+
+// 确定安装范围
+let scope;
+if (forceGlobal) {
+    scope = 'GLOBAL';
+} else if (forceLocal) {
+    scope = 'LOCAL';
+} else {
+    scope = (process.env.SKILL_SCOPE || 'GLOBAL').toUpperCase();
+}
+
+const isGlobal = scope === 'GLOBAL';
+
+// 日志函数
+function log(message, type = 'info') {
+    const prefix =
+        {
+            info: '✓',
+            success: '✓',
+            warning: '⚠',
+            error: '✗',
+        }[type] || '✓';
+
+    console.log(`${prefix} ${message}`);
+}
+
+// 错误处理
+function handleError(error) {
+    log(`安装失败: ${error.message}`, 'error');
+    log('\n您可以尝试手动安装:', 'warning');
+    log(`  npx skills add "${packageRoot}" ${isGlobal ? '-g' : ''} -y`);
+    process.exit(1);
+}
+
+try {
+    log(`开始安装 Hello World Skill...`, 'info');
+    log(`安装范围: ${isGlobal ? '全局(GLOBAL)' : '项目级(LOCAL)'}`, 'info');
+
+    // 构建 skills 命令
+    const commandParts = [
+        'npx',
+        'skills',
+        'add',
+        `"${packageRoot}"`,
+    ];
+
+    if (isGlobal) {
+        commandParts.push('-g');
+    }
+
+    commandParts.push('-y'); // 非交互模式
+
+    const command = commandParts.join(' ');
+
+    if (dryRun) {
+        log('\n[DRY-RUN] 将要执行的命令:', 'warning');
+        console.log(`  ${command}`);
+        log(
+            '\n测试通过 - 实际安装请运行: npm run install:global 或 npm run install:local',
+            'success'
+        );
+        process.exit(0);
+    }
+
+    // 执行安装
+    log('\n正在执行 skills add...', 'info');
+    execSync(command, {
+        stdio: 'inherit',
+        cwd: packageRoot,
+    });
+
+    log('\n安装成功!', 'success');
+    log(
+        `Skill 已安装到: ${isGlobal ? '~/.claude/skills/hello-world' : '.claude/skills/hello-world'}`,
+        'info'
+    );
+
+    // 显示使用指南
+    printUsageGuide();
+} catch (error) {
+    handleError(error);
+}

package/scripts/uninstall-skill.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+/**
+ * Hello World Skill 卸载脚本
+ * 从 Claude Code 中移除 skill
+ *
+ * 命令行参数 (推荐):
+ * --global: 强制全局卸载
+ * --local: 强制项目级卸载
+ *
+ * 环境变量 (备用):
+ * - SKILL_SCOPE: 安装范围,可选值: GLOBAL(全局) 或 LOCAL(项目级),默认: GLOBAL
+ */
+
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const forceGlobal = args.includes('--global');
+const forceLocal = args.includes('--local');
+
+// 确定安装范围
+let scope;
+if (forceGlobal) {
+    scope = 'GLOBAL';
+} else if (forceLocal) {
+    scope = 'LOCAL';
+} else {
+    scope = (process.env.SKILL_SCOPE || 'GLOBAL').toUpperCase();
+}
+
+const isGlobal = scope === 'GLOBAL';
+
+// 日志函数
+function log(message, type = 'info') {
+    const prefix =
+        {
+            info: '✓',
+            success: '✓',
+            warning: '⚠',
+            error: '✗',
+        }[type] || '✓';
+
+    console.log(`${prefix} ${message}`);
+}
+
+// 递归删除目录
+function removeDirectory(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        return false;
+    }
+
+    try {
+        fs.rmSync(dirPath, { recursive: true, force: true });
+        return true;
+    } catch (error) {
+        log(`删除 ${dirPath} 失败: ${error.message}`, 'error');
+        return false;
+    }
+}
+
+try {
+    log(`开始卸载 Hello World Skill...`, 'info');
+    log(`卸载范围: ${isGlobal ? '全局(GLOBAL)' : '项目级(LOCAL)'}`, 'info');
+
+    let removedCount = 0;
+
+    if (isGlobal) {
+        // 全局卸载
+        const homeDir = os.homedir();
+        const paths = [
+            path.join(homeDir, '.claude', 'skills', 'hello-world'),
+            path.join(homeDir, '.agents', 'skills', 'hello-world'),
+        ];
+
+        paths.forEach((dirPath) => {
+            if (removeDirectory(dirPath)) {
+                log(`已删除: ${dirPath}`, 'success');
+                removedCount++;
+            }
+        });
+    } else {
+        // 项目级卸载
+        const cwd = process.cwd();
+        const paths = [
+            path.join(cwd, '.claude', 'skills', 'hello-world'),
+            path.join(cwd, '.agents', 'skills', 'hello-world'),
+        ];
+
+        paths.forEach((dirPath) => {
+            if (removeDirectory(dirPath)) {
+                log(`已删除: ${dirPath}`, 'success');
+                removedCount++;
+            }
+        });
+    }
+
+    if (removedCount > 0) {
+        log(`\n卸载成功! 已删除 ${removedCount} 个目录`, 'success');
+    } else {
+        log('\n未找到已安装的 skill 文件', 'warning');
+    }
+} catch (error) {
+    log(`卸载失败: ${error.message}`, 'error');
+    process.exit(1);
+}

package/scripts/usage-guide.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+/**
+ * 技能使用指南生成器
+ * 在安装成功后显示友好的使用指南
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * 读取 package.json 中的信息
+ */
+function getPackageInfo() {
+    const packageRoot = path.resolve(__dirname, '..');
+    const packageJsonPath = path.join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+
+    return {
+        name: packageJson.name.split('/')[1] || packageJson.name,
+        description: packageJson.description,
+        homepage: packageJson.homepage || '',
+        repository: packageJson.repository?.url || '',
+    };
+}
+
+/**
+ * 读取 SKILL.md 中的触发指令
+ */
+function getSkillInstructions() {
+    const packageRoot = path.resolve(__dirname, '..');
+    const skillMdPath = path.join(packageRoot, 'SKILL.md');
+
+    if (!fs.existsSync(skillMdPath)) {
+        return null;
+    }
+
+    const content = fs.readFileSync(skillMdPath, 'utf-8');
+    // 匹配 description 行中的指令说明
+    const match = content.match(/^description:\s*(.+)$/m);
+    return match ? match[1].trim() : null;
+}
+
+/**
+ * 打印使用指南
+ */
+function printUsageGuide() {
+    const pkg = getPackageInfo();
+    const instructions = getSkillInstructions();
+
+    // 如果 SKILL.md 中有指令说明，使用它；否则使用 package.json 的 description
+    const usageInfo = instructions || pkg.description;
+
+    const guide = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🎉 技能安装成功！
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📦 技能名称:    ${pkg.name}
+📝 功能描述:    ${pkg.description}
+
+🚀 如何使用:
+   ${usageInfo}
+
+📖 更多信息:
+   ${pkg.homepage ? `   文档: ${pkg.homepage}` : ''}
+   ${pkg.repository ? `   仓库: ${pkg.repository}` : ''}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`;
+
+    console.log(guide);
+}
+
+module.exports = { printUsageGuide };