Content
# agent-skills
A personal collection of reusable AI agent skills and MCP-related utilities.
This repository collects personal daily-used agent skills, including web page reading, command line invocation specifications, automation processes, and tool integration experiences. The content mainly consists of directly copyable and usable `SKILL.md` files, and may also include MCP server configurations and examples in the future.
## Installation
Copy the required skill to your agent skill directory.
### Codex
It is recommended to use PowerShell 7+ (`pwsh`). The `powershell-safe-invocation` skill is written for modern PowerShell behavior, focusing on native command parameter passing, paths, quotes, encoding, and process startup.
- Installation Guide: [Install PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell)
- Release Page: [PowerShell GitHub Releases](https://github.com/PowerShell/PowerShell/releases)
```powershell
$repo = (Get-Location).Path
$target = "$env:USERPROFILE\.codex\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
```
### Other Agents
If your agent uses a different skill directory, such as `~/.agents/skills`, change `$target` to the corresponding path.
## bilibili-page-reader Environment and Dependencies
`bilibili-page-reader` is used to read Bilibili video page content: prioritize obtaining submission subtitles, bullet comments summary, and comments; if there are no submission subtitles, proceed with audio download and local ASR transcription.
Running this skill mainly depends on the following tools:
- [Kimi WebBridge](https://www.kimi.com/features/webbridge): Allows agents to access real browser pages for reading current Bilibili page status and content visible after login.
- [Bilibili Evolved](https://github.com/the1812/Bilibili-Evolved): Provides page data sources such as submission subtitles and bullet comments.
- Node.js: Used for requesting Bilibili playurl API and downloading audio streams.
- `ffmpeg` / `ffprobe`: Used for audio format conversion and duration reading.
- Python + [FunASR](https://github.com/modelscope/FunASR): When there are no submission subtitles, transcribe the downloaded audio into SRT/VTT/JSON.
Related auxiliary files:
- `skills/bilibili-page-reader/audio2srt.py`: Audio to subtitle script.
- `skills/bilibili-page-reader/clean_srt.py`: SRT cleaning script.
- `skills/bilibili-page-reader/agents/openai.yaml`: Agent interface metadata.
More specific execution steps, fallback strategies, and common issues are written in `skills/bilibili-page-reader/SKILL.md`.
## Available Skills
| Skill | Description |
| --- | --- |
| [`bilibili-page-reader`](skills/bilibili-page-reader/) | Reads Bilibili video pages, including submission subtitles, bullet comments summary, and comments; if there are no subtitles, downloads audio and transcribes it through FunASR. |
| [`powershell-safe-invocation`](skills/powershell-safe-invocation/) | A safe PowerShell invocation specification for Windows agents, covering native command parameters, paths, quotes, encoding, and process startup. |
## Repository Structure
```text
skills/ Reusable agent skills
mcp/ Reserved for future MCP servers, configurations, and examples
```
Each skill is placed in an independent directory and uses `SKILL.md` as the entry point. Some skills may also include auxiliary scripts, examples, or agent-specific metadata.
## License
[MIT](LICENSE)