agent-skills
A personal collection of reusable AI agent skills and MCP-related utilities.
这个仓库用于收集个人日常使用中沉淀下来的 agent skills，包括网页读取、命令行调用规范、自动化流程、工具集成经验等。内容以可直接复制使用的 SKILL.md 为主，后续也可能加入 MCP server 配置和示例。
安装
复制需要的 skill 到通用的 .agents/skills 技能目录即可，支持该目录的 agent 可以共享同一份安装。
通用安装
推荐使用 PowerShell 7+ (pwsh)。powershell-safe-invocation skill 针对现代 PowerShell 行为编写，尤其关注原生命令参数传递、路径、引号、编码和进程启动。
- 安装指南：Install PowerShell
- 发布页面：PowerShell GitHub Releases
$repo = (Get-Location).Path
$target = "$env:USERPROFILE\.agents\skills"
New-Item -ItemType Directory -Force -Path $target | Out-Null
Copy-Item -LiteralPath "$repo\skills\bilibili-page-reader" -Destination $target -Recurse -Force
Copy-Item -LiteralPath "$repo\skills\powershell-safe-invocation" -Destination $target -Recurse -Force
Copy-Item -LiteralPath "$repo\skills\locus-unity-bridge" -Destination $target -Recurse -Force
自定义技能目录
如果你的 agent 不支持 ~/.agents/skills，把 $target 改成它使用的技能目录即可。
bilibili-page-reader 的工作环境与依赖
bilibili-page-reader 用来读取 Bilibili 视频页内容：优先获取投稿字幕、弹幕摘要和评论；如果没有投稿字幕，再走音频下载和本地 ASR 转写。
运行这个 skill 主要依赖这几类工具：
- Kimi WebBridge：让 agent 访问真实浏览器页面，用于读取当前 Bilibili 页面状态和登录后可见内容。
- Bilibili Evolved：提供投稿字幕、弹幕等页面内数据来源。
- Node.js：用于请求 Bilibili playurl API 和下载音频流。
ffmpeg/ffprobe：用于音频格式转换和时长读取。- Python + FunASR：无投稿字幕时，把下载到的音频转写成 SRT/VTT/JSON。
相关辅助文件：
skills/bilibili-page-reader/audio2srt.py：音频转字幕脚本。skills/bilibili-page-reader/clean_srt.py：SRT 清理脚本。skills/bilibili-page-reader/agents/openai.yaml：agent 界面元数据。
更具体的执行步骤、兜底策略和常见问题写在 skills/bilibili-page-reader/SKILL.md 中。
locus-unity-bridge 的工作环境与依赖
locus-unity-bridge 用于通过 Locus 检测并控制真实 Unity Editor，运行环境是 Windows 和 PowerShell 7。实际连接需要目标 Unity 项目已经安装 Locus package，并启用对应项目的 Bridge。
skill 会先通过 probe 区分缺少 package、Bridge 未启用和 Unity 不可达等状态；缺少 package 时只提供诊断，不会自动安装或修改项目。
可用 Skills
| Skill | 说明 |
|---|---|
bilibili-page-reader | 读取 Bilibili 视频页，包括投稿字幕、弹幕摘要、评论；无字幕时可通过 FunASR 下载音频并转写。 |
locus-unity-bridge | 通过 Locus 检测并控制真实 Unity Editor，支持项目/package/Bridge 诊断、C# 执行和脚本重新编译。 |
powershell-safe-invocation | Windows agent 的安全 PowerShell 调用规范，覆盖原生命令参数、路径、引号、编码和进程启动。 |
仓库结构
skills/ 可复用的 agent skills
mcp/ 预留给未来的 MCP servers、配置和示例
每个 skill 都放在独立目录中，并以 SKILL.md 作为入口。有些 skill 还会包含辅助脚本、示例或 agent 专用元数据。