killer-skills 1.6.0

package/CHANGELOG.md

@@ -0,0 +1,156 @@
+# Changelog
+
+All notable changes to Killer-Skills CLI will be documented in this file.
+
+## [1.6.0] - 2026-01-31
+
+### Added
+- **MCP Server**: Expose CLI as MCP server for AI agents
+  - `killer-skills-mcp` binary for stdio transport
+  - 5 Tools: list_skills, read_skill, search_skills, match_task, get_skill_info
+  - 2 Resources: skills://list, skills://{name}
+
+- **submit command**: Submit skills to registry
+  - `killer submit ./skill --dry-run` - Validate before submission
+  - Parses and validates SKILL.md metadata
+
+- **stats command**: CLI usage statistics
+  - Track installs and command usage
+  - `killer stats --json` - Export as JSON
+
+- **plugin command**: Plugin management
+  - `killer plugin list` - List installed plugins
+  - `killer plugin add ./path` - Install plugin
+  - `killer plugin remove name` - Uninstall plugin
+
+- **Plugin system**: Extensible architecture
+  - Command plugins, IDE adapter plugins, hook plugins
+  - Plugin manifest format (plugin.json)
+
+### Changed
+- Version bumped to 1.6.0
+- Total commands: 18
+
+## [1.5.0] - 2026-01-31
+
+### Added
+- **do command**: Natural language task execution
+  - `killer do "处理PDF文件"` - Auto-match and execute skills
+  - `killer do "..." --list` - List matches without executing
+  - `killer do "..." -y` - Auto-execute best match
+
+- **outdated command**: Check for skill updates
+  - `killer outdated` - Show all skills with available updates
+  - `killer outdated -v` - Show detailed update info
+
+- **deps command**: Dependency management
+  - `killer deps` - Check all skill dependencies
+  - `killer deps <skill>` - Check specific skill
+  - `killer deps --tree` - Show dependency tree
+
+- **Auto-sync option**: `killer install <source> --sync`
+  - Automatically runs sync after installation
+
+- **Unit tests**: 24 test cases covering core utilities
+  - Dependencies parsing tests
+  - GitHub utilities tests  
+  - Platform utilities tests
+
+### Changed
+- Version bumped to 1.5.0
+- Total commands: 15
+
+## [1.4.0] - 2026-01-31
+
+
+### Added
+- **search command**: Search for skills on GitHub and the registry
+  - `killer search <query>` - Search all sources
+  - `killer search <query> -s github` - Search GitHub only
+  - `killer search <query> -s registry` - Search registry only
+  
+- **publish command**: Validate and prepare skills for publication
+  - `killer publish <path>` - Validate skill structure
+  - `killer publish <path> --dry-run` - Validate without changes
+  - `killer publish <path> --github` - Initialize as GitHub repo
+
+- **init command**: Initialize skills in a project
+  - `killer init` - Interactive IDE selection
+  - `killer init -i <ide>` - Specify IDE
+  - Creates skills directory and IDE config file
+
+- **config command**: Manage CLI configuration
+  - `killer config` - List all settings
+  - `killer config <key> <value>` - Set a value
+  - `killer config --reset` - Reset to defaults
+
+- **completion command**: Shell auto-completion
+  - `killer completion bash` - Generate bash completion
+  - `killer completion zsh` - Generate zsh completion
+  - `killer completion fish` - Generate fish completion
+
+## [1.3.0] - 2026-01-31
+
+### Added
+- **Unified install command**: Single entry point for all installation sources
+  - GitHub: `killer install owner/repo`
+  - Local: `killer install ./path` or `~/path`
+  - Registry: `killer install skill-name`
+
+- **IDE-specific prompt templates**: Different formats for different IDEs
+  - Claude/Antigravity: XML format (OpenSkills compatible)
+  - Cursor: Markdown list format
+  - Windsurf: Markdown table format
+
+- **Improved create command**:
+  - `killer create <name> -t minimal` - Single SKILL.md only
+  - `killer create <name> -t standard` - With scripts/ and references/
+  - `killer create <name> -t full` - Full structure with examples/
+  - `killer create <name> --from <skill>` - Clone existing skill
+
+### Changed
+- Converted entire codebase to TypeScript
+- Removed legacy JavaScript files
+- Removed old installers directory (logic merged into install.ts)
+
+## [1.2.0] - 2026-01-31
+
+### Added
+- **manage command**: Interactive skill management
+  - `killer manage` - Select skills to remove
+  - `killer manage --remove-all` - Remove all skills
+
+### Changed
+- **list command** completely refactored:
+  - Groups by project/global location
+  - Added `--verbose` flag for detailed info
+  - Added `--ide <ide>` filter
+  - Shows summary statistics
+
+- **skills.ts**: Added symbolic link support for local development
+
+## [1.1.0] - 2026-01-31
+
+### Added
+- **sync command**: Generate AI-discoverable prompts
+  - `killer sync` - Sync to appropriate file
+  - `killer sync -i <ide>` - Specify target IDE
+  - `killer sync --remove` - Remove skills section
+
+- **read command**: Output skill content to stdout
+  - `killer read <name>` - Single skill
+  - `killer read skill1,skill2` - Multiple skills
+
+- **update command**: Update skills from their source
+  - `killer update` - Update all skills
+  - `killer update <name>` - Update specific skill
+
+- **Metadata tracking**: `.killer-meta.json` for each installed skill
+  - Tracks installation source (git, local, registry)
+  - Enables update functionality
+
+## [1.0.0] - Initial Release
+
+### Commands
+- `install` - Install skills from registry
+- `list` - List installed skills

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Killer-Skills Team
+
+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,360 @@
+# Killer Skills CLI
+
+> 跨平台 AI Agent Skills 安装与管理工具
+
+[![npm version](https://badge.fury.io/js/killer-skills.svg)](https://www.npmjs.com/package/killer-skills)
+
+## ✨ 特性
+
+- 🚀 **统一安装** - 从 GitHub、Registry 或本地一键安装
+- 🔍 **智能搜索** - 在 GitHub 和 Registry 中搜索 Skills
+- ✨ **模板创建** - 3 种模板快速创建新 Skill
+- 📦 **发布工具** - 验证并准备 Skills 发布到 GitHub
+- 🔄 **版本更新** - 追踪来源，一键更新
+- 🤖 **AI 发现** - 同步到 AGENTS.md，让 AI 自动发现
+- 🎯 **多 IDE 支持** - 自动检测并适配不同 IDE
+- ⚡ **Shell 补全** - 支持 bash/zsh/fish 自动补全
+
+## 支持的 IDE
+
+| IDE | 状态 | Skills 目录 |
+|-----|------|-------------|
+| Claude Code | ✅ 完整支持 | `.claude/skills/` |
+| Antigravity | ✅ 完整支持 | `.agent/skills/` |
+| Cursor | ✅ 完整支持 | `.cursor/skills/` |
+| Windsurf | ✅ 完整支持 | `.windsurf/rules/` |
+| VS Code + Copilot | ✅ 支持 | `.github/instructions/` |
+| Kiro | ✅ 支持 | `.kiro/agents/` |
+| Aider | ✅ 支持 | `.aider/` |
+| Goose | ✅ 支持 | `.goose/skills/` |
+
+## 快速开始
+
+```bash
+# 使用 npx (推荐)
+npx killer-skills install <skill-or-repo>
+
+# 或全局安装
+npm install -g killer-skills
+```
+
+## 命令速查
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `install` | 安装 Skill | `killer install pdf` |
+| `list` | 列出已安装 | `killer list` |
+| `create` | 创建新 Skill | `killer create my-skill` |
+| `sync` | 同步到 AGENTS.md | `killer sync` |
+| `read` | 读取 Skill 内容 | `killer read pdf` |
+| `update` | 更新 Skills | `killer update` |
+| `manage` | 交互式管理 | `killer manage` |
+| `search` | 搜索 Skills | `killer search pdf` |
+| `publish` | 发布 Skill | `killer publish .` |
+| `init` | 初始化项目 | `killer init` |
+| `config` | 配置管理 | `killer config` |
+| `completion` | Shell 补全 | `killer completion zsh` |
+| `do` | 自然语言执行 | `killer do "处理PDF"` |
+| `outdated` | 检查更新 | `killer outdated` |
+| `deps` | 依赖管理 | `killer deps` |
+| `submit` | 提交到 Registry | `killer submit .` |
+| `stats` | 使用统计 | `killer stats` |
+| `plugin` | 插件管理 | `killer plugin list` |
+
+---
+
+## 📦 安装 Skills
+
+```bash
+# 从 Registry 安装
+killer install pdf
+
+# 从 GitHub 安装
+killer install anthropics/killer-skills
+
+# 从本地安装
+killer install ./my-skill
+killer install ~/dev/my-skill
+
+# 指定 IDE
+killer install pdf --ide cursor
+
+# 安装到全局
+killer install pdf --scope global
+
+# 安装到所有 IDE
+killer install pdf --all
+```
+
+## ✨ 创建新 Skill
+
+```bash
+# 标准模板 (默认)
+killer create my-awesome-skill
+
+# 最小模板 - 仅 SKILL.md
+killer create my-skill -t minimal
+
+# 完整模板 - 含 scripts, references, examples, assets
+killer create my-skill -t full
+
+# 从已有 Skill 克隆
+killer create my-skill --from pdf
+
+# 指定描述
+killer create my-skill -d "处理 PDF 文件的技能"
+```
+
+## 🔄 同步与更新
+
+```bash
+# 同步到 AGENTS.md (让 AI 发现 Skills)
+killer sync
+
+# 指定 IDE 格式
+killer sync -i cursor
+killer sync -i windsurf
+
+# 更新所有 Skills
+killer update
+
+# 更新特定 Skill
+killer update pdf
+
+# 读取 Skill 内容
+killer read pdf
+killer read pdf,docx,xlsx
+```
+
+## 🔍 搜索与发现
+
+```bash
+# 搜索所有来源
+killer search pdf
+
+# 只搜索 GitHub
+killer search pdf -s github
+
+# 只搜索 Registry
+killer search pdf -s registry
+
+# 限制结果数量
+killer search pdf -l 5
+```
+
+## 📤 发布 Skill
+
+```bash
+# 验证 Skill (dry run)
+killer publish ./my-skill --dry-run
+
+# 准备 GitHub 发布
+killer publish ./my-skill --github
+```
+
+## 🛠️ 项目初始化
+
+```bash
+# 交互式初始化
+killer init
+
+# 指定 IDE
+killer init -i cursor
+
+# 跳过提示
+killer init -y
+```
+
+## ⚙️ 配置管理
+
+```bash
+# 查看所有配置
+killer config
+
+# 设置默认 IDE
+killer config defaultIDE cursor
+
+# 设置默认作用域
+killer config defaultScope project
+
+# 设置 GitHub Token
+killer config githubToken ghp_xxx
+
+# 重置配置
+killer config --reset
+```
+
+## 🧠 自然语言执行
+
+```bash
+# 用自然语言描述任务
+killer do "处理这个PDF文件"
+
+# 列出匹配的 Skills
+killer do "create algorithmic art" --list
+
+# 自动执行最佳匹配
+killer do "处理Excel表格" -y
+```
+
+## 📊 版本检测
+
+```bash
+# 检查所有 Skills 更新
+killer outdated
+
+# 显示详细信息
+killer outdated -v
+```
+
+## 🔗 依赖管理
+
+```bash
+# 检查所有依赖
+killer deps
+
+# 检查特定 Skill
+killer deps pdf
+
+# 显示依赖树
+killer deps --tree
+```
+
+## 🔌 MCP Server
+
+将 CLI 作为 MCP Server 暴露给 AI Agent：
+
+```bash
+# 启动 MCP Server
+npx killer-skills-mcp
+
+# 在 Claude/Cursor 配置中添加:
+# "killer-skills": {
+#   "command": "npx",
+#   "args": ["killer-skills-mcp"]
+# }
+```
+
+**可用 Tools:**
+- `list_skills` - 列出已安装 skills
+- `read_skill` - 读取 skill 内容
+- `search_skills` - 搜索 skills
+- `match_task` - 自然语言匹配
+- `get_skill_info` - 获取详细信息
+
+## 📤 提交到 Registry
+
+```bash
+# 验证 Skill
+killer submit ./my-skill --dry-run
+
+# 提交
+killer submit ./my-skill
+```
+
+## 📊 使用统计
+
+```bash
+# 查看统计
+killer stats
+
+# JSON 格式
+killer stats --json
+
+# 重置
+killer stats --reset
+```
+
+## 🔌 插件管理
+
+```bash
+# 列出插件
+killer plugin list
+
+# 安装插件
+killer plugin add ./my-plugin
+
+# 卸载插件
+killer plugin remove my-plugin
+```
+
+## 🐚 Shell 自动补全
+
+```bash
+# Bash
+killer completion bash >> ~/.bashrc
+
+# Zsh
+killer completion zsh >> ~/.zshrc
+
+# Fish
+killer completion fish > ~/.config/fish/completions/killer.fish
+```
+
+## 📋 交互式管理
+
+```bash
+# 选择要删除的 Skills
+killer manage
+
+# 删除所有 Skills
+killer manage --remove-all
+```
+
+## 🔧 命令选项
+
+### `install <source>`
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-i, --ide <ide>` | 目标 IDE | 自动检测 |
+| `-s, --scope <scope>` | 安装范围: project/global | global |
+| `--all` | 安装到所有 IDE | false |
+| `-y, --yes` | 跳过确认 | false |
+
+### `create <name>`
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-t, --template <type>` | 模板: minimal/standard/full | standard |
+| `-d, --description <desc>` | Skill 描述 | - |
+| `-p, --path <path>` | 输出目录 | . |
+| `--from <skill>` | 克隆已有 Skill | - |
+
+### `list`
+
+| 选项 | 说明 |
+|------|------|
+| `-i, --ide <ide>` | 按 IDE 筛选 |
+| `-v, --verbose` | 显示详细信息 |
+
+### `sync`
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-i, --ide <ide>` | 目标 IDE | 自动检测 |
+| `-o, --output <path>` | 输出文件 | 自动 |
+| `--remove` | 移除 Skills 部分 | false |
+
+### `search <query>`
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-s, --source <source>` | 来源: all/github/registry | all |
+| `-l, --limit <number>` | 最大结果数 | 10 |
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `GITHUB_TOKEN` | GitHub 访问令牌，提高 API 速率限制 |
+
+## 前置要求
+
+发布 Skill 到 GitHub 需要:
+1. 安装 [GitHub CLI (gh)](https://cli.github.com/)
+2. 运行 `gh auth login` 完成认证
+
+## 许可证
+
+MIT

package/dist/commands/completion.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Completion Command
+ *
+ * Generate shell completion scripts for bash, zsh, and fish.
+ */
+import { Command } from 'commander';
+export declare const completionCommand: Command;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,iBAAiB,SAiBxB,CAAC"}