القائمة
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