@allanpk716/work-skills-setup 0.1.0 → 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 allanpk716
+
+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,227 @@
+# Work Skills
+
+English | [中文](README.zh.md)
+
+Personal skills collection for improving daily work efficiency with Claude Code.
+
+## 🚀 Quick Start
+
+**New to Work Skills?** Just run:
+
+```bash
+npx github:allanpk716/work-skills#main
+```
+
+**Prefer manual install?**
+
+```bash
+git clone https://github.com/allanpk716/work-skills.git
+cd work-skills
+node installer/src/index.js
+```
+
+**Need details?** See **[Quick Start Guide](QUICK-START.md)**
+
+**Already installed?** Run `git pull && npx .` to update
+
+---
+
+## Prerequisites
+
+- Windows development environment
+- Git with SSH (PuTTY/Pageant) configured
+- Node.js environment installed (for Claude Code plugin system)
+
+## Installation
+
+### NPX Install (Recommended)
+
+One-line install via GitHub:
+
+```bash
+npx github:allanpk716/work-skills#main
+```
+
+This automatically downloads and runs the installer. No clone needed.
+
+### Official Project Install
+
+```bash
+npx allanpk716/work-skills
+```
+
+### Register as Plugin Marketplace
+
+Run the following command in Claude Code:
+
+```
+/plugin marketplace add allanpk716/work-skills
+```
+
+### Install Skills
+
+**Option 1: Via Browse UI**
+
+1. Select __Browse and install plugins__
+2. Select __work-skills__
+3. Select the plugin(s) you want to install
+4. Select __Install now__
+
+**Option 2: Direct Install**
+
+```
+# Install git skills plugin
+/plugin install git-skills@work-skills
+```
+
+**Option 3: Ask the Agent**
+
+Simply tell Claude Code:
+
+> Please install Skills from github.com/allanpk716/work-skills
+
+## Available Plugins
+
+| Plugin | Description | Skills |
+| --- | --- | --- |
+| __git-skills__ | Git workflow automation for Windows | windows-git-commit |
+| __claude-notify__ | Task completion notifications via Pushover and Windows Toast | claude-notify |
+
+## Update Skills
+
+To update skills to the latest version:
+
+1. Run `/plugin` in Claude Code
+2. Switch to __Marketplaces__ tab
+3. Select __work-skills__
+4. Choose __Update marketplace__
+
+You can also __Enable auto-update__ to get the latest versions automatically.
+
+## Available Skills
+
+### Git Skills
+
+Git workflow automation skills optimized for Windows development with PuTTY/Pageant authentication.
+
+#### windows-git-commit
+
+Automated Git commit and push for Windows using command-line git with plink + PPK authentication.
+
+**Features:**
+- Auto-analyzes code changes
+- Generates descriptive commit messages
+- Uses command-line git (no GUI dialogs)
+- Configures PuTTY/plink SSH authentication automatically
+- Runs in subagent to preserve context
+
+**Usage:**
+
+```bash
+# Automatic commit and push (recommended)
+/windows-git-commit
+
+# With custom commit message
+/windows-git-commit Commit message here
+
+# Commit specific files only
+/windows-git-commit for changes in src/ and tests/
+```
+
+**Prerequisites:**
+- Pageant must be running with PPK key loaded
+- TortoiseGit or PuTTY must be installed
+- First run auto-configures git to use TortoisePlink
+
+**One-time Setup:**
+
+```bash
+# Configure git to use TortoisePlink (64-bit system)
+git config --global core.sshcommand "\"C:\\Program Files\\TortoiseGit\\bin\\TortoisePlink.exe\""
+
+# Or 32-bit system
+git config --global core.sshcommand "\"C:\\Program Files (x86)\\TortoiseGit\\bin\\TortoisePlink.exe\""
+```
+
+For detailed troubleshooting, see the skill documentation.
+
+### Claude Notify
+
+Task completion notifications via Pushover and Windows Toast.
+
+#### claude-notify
+
+Automatically sends notifications when Claude Code completes tasks. Receive mobile push notifications via Pushover and desktop toast notifications on Windows.
+
+**Features:**
+- Mobile push notifications via Pushover
+- Windows Toast desktop notifications
+- AI-powered task summaries using Claude CLI
+- Parallel execution for instant delivery
+- Graceful degradation when Pushover not configured
+- Completes within 5 seconds
+
+**Usage:**
+
+No manual invocation needed - notifications are sent automatically when Claude Code tasks complete.
+
+**Prerequisites:**
+- Python 3.8 or higher
+- Pushover account (optional, for mobile notifications)
+
+**Setup:**
+
+1. **Configure Pushover (optional):**
+
+```cmd
+# Windows Command Prompt
+setx PUSHOVER_TOKEN "your-pushover-app-token"
+setx PUSHOVER_USER "your-pushover-user-key"
+```
+
+2. **Verify installation:**
+
+```bash
+python scripts/verify-installation.py
+```
+
+3. **Test:**
+
+Complete any task in Claude Code. You should receive notifications automatically.
+
+**Without Pushover:**
+
+Windows Toast notifications work without any configuration. Just install the plugin and you're ready to go.
+
+For detailed documentation, see the [skill documentation](plugins/claude-notify/SKILL.md).
+
+## Project Structure
+
+```
+work-skills/
+├── .claude-plugin/
+│   └── marketplace.json      # Plugin marketplace configuration
+├── plugins/
+│   ├── windows-git-commit/   # Git workflow automation plugin
+│   │   ├── commands/         # Slash commands
+│   │   └── skills/           # Skill definitions
+│   └── claude-notify/        # Notification plugin
+│       ├── hooks/            # Hook definitions
+│       ├── SKILL.md          # Skill documentation
+│       └── tests/            # Test suite
+├── README.md                 # This file
+├── README.zh.md              # Chinese version
+└── CHANGELOG.md              # Version history
+```
+
+## Contributing
+
+This is a personal skills collection. Feel free to fork and adapt for your own needs!
+
+## License
+
+MIT
+
+## Credits
+
+Structure and organization inspired by [baoyu-skills](https://github.com/JimLiu/baoyu-skills) by Jim Liu.

package/README.zh.md

@@ -0,0 +1,228 @@
+# Work Skills
+
+[English](README.md) | 中文
+
+个人技能集合,用于提升 Claude Code 的日常工作效率。
+
+## 🚀 快速开始
+
+**初次使用?** 直接运行:
+
+```bash
+npx github:allanpk716/work-skills#main
+```
+
+**喜欢手动安装?**
+
+```bash
+git clone https://github.com/allanpk716/work-skills.git
+cd work-skills
+node installer/src/index.js
+```
+
+**详细步骤?** 查看 **[快速安装指南](QUICK-START.md)** 或 **[完整安装文档](INSTALLATION.zh.md)**
+
+**已安装?** 运行 `git pull && npx .` 更新
+
+---
+---
+
+## 前提条件
+
+- Windows 开发环境
+- 已配置 SSH (PuTTY/Pageant) 的 Git
+- 已安装 Node.js 环境 (用于 Claude Code 插件系统)
+
+## 安装
+
+### NPX 安装 (推荐)
+
+通过 GitHub 一键安装:
+
+```bash
+npx github:allanpk716/work-skills#main
+```
+
+自动下载并运行安装程序,无需克隆仓库。
+
+### 官方项目安装
+
+```bash
+npx allanpk716/work-skills
+```
+
+### 注册为插件市场
+
+在 Claude Code 中运行以下命令:
+
+```
+/plugin marketplace add allanpk716/work-skills
+```
+
+### 安装技能
+
+**方式 1: 通过浏览界面**
+
+1. 选择 __Browse and install plugins__
+2. 选择 __work-skills__
+3. 选择要安装的插件
+4. 选择 __Install now__
+
+**方式 2: 直接安装**
+
+```
+# 安装 git 技能插件
+/plugin install git-skills@work-skills
+```
+
+**方式 3: 询问 Agent**
+
+直接告诉 Claude Code:
+
+> Please install Skills from github.com/allanpk716/work-skills
+
+## 可用插件
+
+| 插件 | 描述 | 技能 |
+| --- | --- | --- |
+| __git-skills__ | Windows Git 工作流自动化 | windows-git-commit |
+| __claude-notify__ | 通过 Pushover 和 Windows Toast 发送任务完成通知 | claude-notify |
+
+## 更新技能
+
+更新技能到最新版本:
+
+1. 在 Claude Code 中运行 `/plugin`
+2. 切换到 __Marketplaces__ 标签页
+3. 选择 __work-skills__
+4. 选择 __Update marketplace__
+
+你也可以启用 __自动更新__ 来获取最新版本。
+
+## 可用技能
+
+### Git 技能
+
+为 Windows 开发优化的 Git 工作流自动化技能,支持 PuTTY/Pageant 认证。
+
+#### windows-git-commit
+
+使用命令行 git 和 plink + PPK 认证的自动化 Git 提交和推送。
+
+**特性:**
+- 自动分析代码变更
+- 生成描述性提交信息
+- 使用命令行 git (无 GUI 对话框)
+- 自动配置 PuTTY/plink SSH 认证
+- 在子代理中运行以保留上下文
+
+**用法:**
+
+```bash
+# 自动提交和推送 (推荐)
+/windows-git-commit
+
+# 使用自定义提交信息
+/windows-git-commit Commit message here
+
+# 仅提交特定文件
+/windows-git-commit for changes in src/ and tests/
+```
+
+**前提条件:**
+- Pageant 必须运行并加载了 PPK 密钥
+- 必须安装 TortoiseGit 或 PuTTY
+- 首次运行会自动配置 git 使用 TortoisePlink
+
+**一次性配置:**
+
+```bash
+# 配置 git 使用 TortoisePlink (64位系统)
+git config --global core.sshcommand "\"C:\\Program Files\\TortoiseGit\\bin\\TortoisePlink.exe\""
+
+# 或 32位系统
+git config --global core.sshcommand "\"C:\\Program Files (x86)\\TortoiseGit\\bin\\TortoisePlink.exe\""
+```
+
+详细故障排除请参阅技能文档。
+
+### Claude Notify
+
+通过 Pushover 和 Windows Toast 发送任务完成通知。
+
+#### claude-notify
+
+当 Claude Code 完成任务时自动发送通知。通过 Pushover 接收移动推送通知,在 Windows 系统上接收桌面 Toast 通知。
+
+**特性:**
+- 通过 Pushover 发送移动推送通知
+- Windows Toast 桌面通知
+- 使用 Claude CLI 生成 AI 驱动的任务摘要
+- 并行执行实现即时投递
+- 未配置 Pushover 时优雅降级
+- 在 5 秒内完成
+
+**用法:**
+
+无需手动调用 - 通知在 Claude Code 任务完成时自动发送。
+
+**前提条件:**
+- Python 3.8 或更高版本
+- Pushover 账号(可选,用于移动通知)
+
+**安装配置:**
+
+1. **配置 Pushover(可选):**
+
+```cmd
+# Windows 命令提示符
+setx PUSHOVER_TOKEN "your-pushover-app-token"
+setx PUSHOVER_USER "your-pushover-user-key"
+```
+
+2. **验证安装:**
+
+```bash
+python scripts/verify-installation.py
+```
+
+3. **测试:**
+
+在 Claude Code 中完成任何任务,你应该会自动收到通知。
+
+**不使用 Pushover:**
+
+Windows Toast 通知无需任何配置即可工作。只需安装插件即可开始使用。
+
+详细文档请参阅[技能文档](plugins/claude-notify/SKILL.md)。
+
+## 项目结构
+
+```
+work-skills/
+├── .claude-plugin/
+│   └── marketplace.json      # 插件市场配置
+├── plugins/
+│   ├── windows-git-commit/   # Git 工作流自动化插件
+│   │   ├── commands/         # 斜杠命令
+│   │   └── skills/           # 技能定义
+│   └── claude-notify/        # 通知插件
+│       ├── hooks/            # Hook 定义
+│       ├── SKILL.md          # 技能文档
+│       └── tests/            # 测试套件
+├── README.md                 # 英文说明
+├── README.zh.md              # 中文说明 (本文件)
+└── CHANGELOG.md              # 版本历史
+```
+
+## 贡献
+
+这是个人技能集合。欢迎 fork 并根据你的需求进行调整!
+
+## 许可证
+
+MIT
+
+## 致谢
+
+项目结构和组织方式受到 [baoyu-skills](https://github.com/JimLiu/baoyu-skills) (作者 Jim Liu) 的启发。

package/installer/jest.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  testEnvironment: 'node',
+  testMatch: ['**/tests/**/*.test.js'],
+  collectCoverageFrom: ['src/**/*.js'],
+  coverageDirectory: 'coverage',
+  verbose: true,
+  transformIgnorePatterns: [
+    'node_modules/(?!(execa)/)'
+  ]
+};