lag0/pi-tube
skills/pi-tube/SKILL.md
Official pi-tube CLI skill for deterministic media transcription workflows. USE FOR: - YouTube/Instagram/direct URL/local file transcription via CLI - Deterministic Markdown/JSON artifact generation - Provider auth/default configuration flows - Media downloads via yt-dlp Must be pre-installed. See rules/install.md for installation and setup, and rules/security.md for output handling.
tools
Updated Jun 3, 2026
$ install --global
skillsauthnpx skillsauth add lag0/pi-tube pi-tubeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 3, 2026, 4:07 AM10.8s3 files scanned
SKILL.md
- name:
- pi-tube
- description:
- |
Pi-Tube CLI
Deterministic transcription CLI focused on agent-friendly output contracts.
Run pi-tube --help for current command details.
Prerequisites
pi-tubeavailable in PATH.- Provider credentials configured with
pi-tube auth login <deepgram|groq|elevenlabs>or via environment fallback (DEEPGRAM_API_KEY/GROQ_API_KEY/ELEVENLABS_API_KEY).
If not installed, follow rules/install.md. For output safety and untrusted content handling, follow rules/security.md.
Quick Checks
pi-tube --version
pi-tube --help
pi-tube help transcribe
pi-tube help auth
pi-tube auth status
pi-tube defaults show
Typical Workflow
- Configure credentials and defaults:
pi-tube auth login <deepgram|groq|elevenlabs>
pi-tube auth status
pi-tube defaults provider <deepgram|groq|elevenlabs>
pi-tube defaults language pt-BR
pi-tube defaults show
- Run transcription:
pi-tube transcribe <input>
pi-tube transcribe "https://youtube.com/watch?v=dQw4w9WgXcQ" --provider groq --language pt --json
pi-tube transcribe "./recording.mp3" --timestamps
- Download media when needed:
pi-tube download <url>
pi-tube download "https://youtube.com/watch?v=dQw4w9WgXcQ" --audio
pi-tube download "https://instagram.com/reel/abc123" --output ./media
- Inspect output:
- Default transcription output: deterministic markdown artifact.
transcribe --json: deterministic schema-versioned JSON contract.- Successful transcriptions print
[OUTPUT_FILE]and[OUTPUT_FILE_URI]. - Successful downloads print
[DOWNLOAD_FILE]and[DOWNLOAD_FILE_URI].
Key Commands
pi-tube transcribe <input>
pi-tube transcribe <input> --provider <deepgram|groq|elevenlabs> --language <code> --json
pi-tube download <url>
pi-tube auth login <deepgram|groq|elevenlabs>
pi-tube auth status
pi-tube auth logout <deepgram|groq|elevenlabs>
pi-tube defaults provider <deepgram|groq|elevenlabs>
pi-tube defaults language <code>
pi-tube defaults show
pi-tube setup yt-dlp
pi-tube setup skills --global --yes
Notes
- v2 uses explicit transcription: always call
pi-tube transcribe <input>. - Precedence: CLI flags > config defaults > env defaults.
- Stored API keys are masked in output and saved in
~/.pi-tube/config.jsonwith restricted permissions. - Environment variables remain automatic fallback; no env-link setup command is needed.
- If no provider credential is configured, CLI exits early with deterministic error guidance.
- If selected provider fails with auth/unavailable/failed and an alternate provider is configured, CLI can fallback automatically.
- Instagram private/auth-gated URLs fail with
INSTAGRAM_AUTH_REQUIRED. - For release quality gates, run
bun testandbun run verify:fixtures.
Related Skills
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026
steipete/xurl
tools
VerifiedTrustedCommunity
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
356,423SKILL.mdUpdated Apr 13, 2026