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

仓库结构

skills/   可复用的 agent skills
mcp/      预留给未来的 MCP servers、配置和示例

每个 skill 都放在独立目录中，并以 SKILL.md 作为入口。有些 skill 还会包含辅助脚本、示例或 agent 专用元数据。

许可证

MIT