# Bilibili Note

> Generate Simplified Chinese Obsidian notes from Bilibili or YouTube video URLs. Use when the user wants a local Markdown video study note, transcript, semantic body, key moments, resources, and optional full note structure.

- **Type:** Skill
- **Install:** `agentstack add skill-hyyh-code-agent-skills-bilibili-note`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [HYYH-code](https://agentstack.voostack.com/s/hyyh-code)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [HYYH-code](https://github.com/HYYH-code)
- **Source:** https://github.com/HYYH-code/agent-skills/tree/master/skills/bilibili-note

## Install

```sh
agentstack add skill-hyyh-code-agent-skills-bilibili-note
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# bilibili-note

## When To Use

Use this skill when the user provides a Bilibili or YouTube URL and wants a local Obsidian Markdown note.

Good fits:

- Generate a Simplified Chinese study note from a video.
- Extract or transcribe video speech.
- Build a structured note with summary, key points, timestamps, resources, transcript, and semantic body.
- Save the result into a local Obsidian vault.

Do not use this skill when:

- The user only wants a one-sentence answer and no local note.
- The source is not a video URL.
- The user wants to publish private transcripts or generated notes into a public repository.

## Workflow

1. Detect video service and video ID.
2. Fetch video metadata.
3. Try platform subtitles first.
4. If subtitles are unavailable, download audio and run ASR.
5. ASR fallback order:
   - StepFun StepAudio ASR
   - Local Whisper
6. Generate a Markdown note using templates.
7. Write the note under the configured Obsidian vault.

## Modes

Default mode is minimal:

```bash
python bilibili_note_v3.py "https://www.bilibili.com/video/BV..."
```

Full mode:

```bash
python bilibili_note_v3.py "https://www.bilibili.com/video/BV..." --full
```

Full mode adds semantic body, visual index, knowledge links, questions, TODOs, and folded metadata.

## Privacy Rules

Never hard-code or commit:

- StepFun API keys
- GitHub tokens
- Local Obsidian vault paths
- Downloaded media
- Generated notes or transcripts
- Runtime logs

Use environment variables:

```bash
export BILIBILI_NOTE_VAULT="/path/to/your/obsidian-vault"
export BILIBILI_NOTE_STEPFUN_API_KEY="your-stepfun-key"
```

## Files

- Main entry: `bilibili_note_v3.py`
- Configuration/cache/resources: `core/`
- Network/text/validation helpers: `utils/`
- Video service adapters: `video_services/`
- ASR providers: `transcription/`
- Note analysis and building: `note_processing/`
- Templates: `templates/`
- Tests: `tests/` plus top-level focused tests

## Notes

Generated notes are personal study artifacts. Keep them outside public source control unless the user explicitly decides to publish a sanitized note.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [HYYH-code](https://github.com/HYYH-code)
- **Source:** [HYYH-code/agent-skills](https://github.com/HYYH-code/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hyyh-code-agent-skills-bilibili-note
- Seller: https://agentstack.voostack.com/s/hyyh-code
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.