菜单
Use when setting up the development environment, installing prerequisites, configuring API keys, or troubleshooting missing dependencies like uvx, geckodriver, or Firefox cookies.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when selecting a Gemini model, checking rate limits or quotas, configuring the gemini-rust crate, or debugging model name mismatches.
Create new Kiro skills (Agent Skills). Use when asked to create a skill, write a SKILL.md, add a new workflow to .kiro/skills/, or package agent instructions as a reusable skill.
Use when creating a release, bumping the version, tagging a commit, or working with the GitHub Actions release workflow for rs-summarizer.
Use when editing or creating Askama HTML templates, adding template variables, fixing compile-time template errors, or working with HTMX attributes in templates.
Use when working with tokio::spawn background tasks, the summarization pipeline, task state transitions, or the mark_error/mark_summary_done pattern.
Use when building, running, linting with clippy, formatting with rustfmt, or running cargo commands for the rs-summarizer project.
| name | environment-setup |
| description | Use when setting up the development environment, installing prerequisites, configuring API keys, or troubleshooting missing dependencies like uvx, geckodriver, or Firefox cookies. |
rs-summarizer requires several external tools beyond the Rust toolchain. This skill documents the full prerequisites checklist and how to verify each one.
| Tool | Purpose | Verify Command |
|---|---|---|
| Rust (stable) | Build the project | rustc --version |
uv / uvx | Run yt-dlp without global install | uvx --version |
| Firefox | Cookie source for YouTube auth | firefox --version |
GEMINI_API_KEY | Google Gemini API access | echo $GEMINI_API_KEY |
| geckodriver | Browser integration tests only | geckodriver --version |
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Via pip
pip install uv
# Via Homebrew (macOS/Linux)
brew install uv
# Or see: https://docs.astral.sh/uv/getting-started/installation/
Once installed, uvx yt-dlp will download and run yt-dlp automatically — no separate yt-dlp install needed.
# Store key in a file
echo "your-key-here" > ~/api_key.txt
# Export for the session
export GEMINI_API_KEY=$(cat ~/api_key.txt)
Get a key from: https://aistudio.google.com/apikey
# Download from: https://github.com/mozilla/geckodriver/releases
# Place in ~/bin/ or anywhere in PATH
chmod +x geckodriver
yt-dlp uses --cookies-from-browser firefox to authenticate with YouTube. This requires:
If you get 429 errors or "Sign in to confirm" messages, ensure Firefox has fresh YouTube cookies.
The SQLite database is created automatically on first run at data/summaries.db. The data/ directory must exist:
mkdir -p data
Migrations run automatically via sqlx::migrate!().
export GEMINI_API_KEY=$(cat ~/api_key.txt)
cargo run --release
# Server starts on http://localhost:5001
# 1. Check Rust builds
cargo check
# 2. Check yt-dlp works
uvx yt-dlp --version
# 3. Check unit tests pass
cargo test
# 4. Check API key works (optional)
curl -s "https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY" | head -c 200
| Symptom | Cause | Fix |
|---|---|---|
uvx: command not found | uv not installed | Install uv (see above) |
429 Too Many Requests from yt-dlp | YouTube rate limiting | Wait, or refresh Firefox cookies |
Sign in to confirm | Bot detection | Log into YouTube in Firefox, close Firefox, retry |
Requested format is not available | Missing --format mhtml flag | Already handled in code — check yt-dlp version |
| sqlx compile errors | Missing database | Run mkdir -p data then cargo run once |
| Template compile errors | Askama syntax issue | Check templates/ directory exists at project root |
src/main.rs — Server startup, port 5001, env var loadingsrc/services/transcript.rs — yt-dlp invocation (uses uvx)migrations/001_initial.sql — Database schemaCargo.toml — Rust dependencies