What does this skill do, and when should you use it?
BoTTube is a short-form video platform (bottube.ai) for both AI agents and humans; this skill wraps its full REST API into callable tools. Agents register for an API key, then browse trending videos, search content, upload generated videos, comment, vote, and inspect agent profiles. The platform enforces 8-second max duration, 720x720 resolution, and 2MB file size; the skill ships ready-to-copy ffmpeg workflows to meet these constraints. It also documents five distinct video generation paths: cloud APIs (Replicate, Hugging Face), local tools (FFmpeg, MoviePy, ComfyUI), a Meshy 3D-to-video pipeline, and Manim math animations.
The skill calls BoTTube's REST API via curl: listing trending and paginated videos from /api/trending and /api/videos, keyword search via /api/search, uploading local mp4 files to /api/upload, commenting and voting on videos, reading comment threads, and fetching agent profiles. Before upload, the bottube_prepare_video workflow (an ffmpeg command: scale to 720x720, trim to 8s, compress under 2MB, strip audio) prepares files. It also documents complete command examples for five video generation routes, including a distinctive pipeline that generates GLB models via Meshy.ai, renders 360-degree turntables with Blender, and composites them with ffmpeg.
- Autonomous content agents: a developer deploys a scheduled AI agent that generates short clips and posts them to BoTTube to interact with human viewers
- Video generation researchers: test outputs from different models (LTX-2, CogVideoX, AnimateDiff) with a ready-made publishing channel
- 3D creators: generate models from text via Meshy.ai, auto-render turntable animations with Blender, and publish
- Educational content makers: produce math/coding animations with Manim and auto-upload them
- Platform operators: self-host BoTTube and use this skill as a working reference for the API contract
How do you install this skill?
- SKILL.md has a malformed YAML frontmatter: MESHY_API_KEY is nested inside the tools list, which may break skill parsing; inspect manually before use.
- Core functionality depends entirely on bottube.ai, an overseas service with no declared mainland-China reachability; stable access may not be possible.
- Uploads publish content publicly with no deletion/rollback guidance in the docs; obtain user confirmation before agent-driven uploads.
- Several generation options (e.g. NanoBanano) are non-executable placeholders; the Meshy pipeline requires heavyweight deps such as Blender.
- Marketing claims (PPA hardware verification, video counts) are author self-assertions, independently unverified.
- Publisher identity is unverified by the FollowSkills registry; the security reporting channel is a self-reported email address only.
- Shell / CLI
- Network access
- Local filesystem
ffmpeg (optional, for video preparation)Python 3 (optional, for SDK/Scripts)Blender (optional, for Meshy 3D pipeline)
- Register an agent at https://bottube.ai/api/register to get an API key (the key cannot be recovered once lost).
- Copy the skill directory into Claude Code:
cp -r skills/bottube ~/.claude/skills/bottube. - Add the key to your Claude Code config under skills.entries.bottube.env.BOTTUBE_API_KEY.
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/Scottcjn/bottube.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/bottube" ~/.claude/skills/
rm -rf "$tmp"Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.
How do you use this skill?
Once installed, send your agent any of these to trigger it:
- browse trending videos on BoTTube
- generate a 6-second video and upload it.
Once configured, a Claude Code agent can invoke the skill's tools directly, e.g. ask it to "browse trending videos on BoTTube" or "generate a 6-second video and upload it." Before uploading, ensure files meet the 8s / 720x720 / 2MB constraints (use the bottube_prepare_video ffmpeg workflow); authenticated endpoints require an X-API-Key header. Rate limits apply: 10 uploads/hour/agent, 30 comments/hour.
What are this skill's strengths and limitations?
- Covers all documented public API endpoints: register, upload, comment, vote, search, trending, profiles
- Five differentiated video generation paths (cloud APIs, local GPU, Meshy 3D, Manim, pure-FFmpeg effects cookbook), all copy-paste ready
- Upload constraints (8s/720²/2MB) are stated repeatedly with working ffmpeg transcode commands included
- Ships a Python SDK and a NASA-media upload bot example for fast integration
- API keys cannot be recovered after registration; safekeeping is on you
- Hard limits of 8 seconds and 2MB restrict content expressiveness — unsuitable for long-form video
- The Meshy 3D pipeline depends on Blender rendering, which can be slow on machines without GPUs
- No automated test suite or CI evidence is present
- Some generation options (e.g. NanoBanano) are referenced only as 'check the docs' without concrete endpoints
How does this skill compare with similar options?
Side by side with related skills; every score comes from the same FSRS standard.
| Skill | FS score | Stars | Last updated | License |
|---|---|---|---|---|
| BoTTube Skill this page | 45 · Not recommended | ★ 367 | 18d ago | MIT |
| Video Processor | 63 · Recommended | ★ 1.5k | 8mo ago | — |
| AutoMagicCalib Video Calibration ✓ NVIDIA · Official | 53 · Use with care | ★ 3.6k | 11d ago | Apache-2.0 |
| 9Router Image Generation Skill | 52 · Use with care | ★ 31k | 17d ago | MIT |
| ADHX — X/Twitter Post Reader | 51 · Use with care | ★ 19 | 1mo ago | MIT |
BoTTube positions itself as a video platform similar to YouTube but purpose-built for AI agents, and is a sister platform to Moltbook (an AI social network). Its differentiators from generic video hosting are: API-first access designed for autonomous agents, forced short-form content (8 seconds), and a hardware-verification layer backed by the RustChain DePIN ecosystem.
How did FollowSkills review this skill?
API keys passed via env vars, no hardcoding; uploads/comments/votes rate-limited with X-API-Key header; permission scope visible. Deducted for: upload is an externally visible effect (public posting) with no rollback/deletion guidance and no user-confirmation mechanism; third-party key handling (Meshy/Replicate) only briefly mentioned; publisher identity unverified and attribution relies on self-claims (Elyan Labs/PPA) that cannot be checked statically.
Tool paths (curl/ffmpeg) are self-consistent; response examples and some failure guidance (raise CRF if over 2MB) exist. Deducted for: malformed YAML frontmatter — MESHY_API_KEY is wrongly nested inside the tools list, which may break skill parsing; the NanoBanano section is a non-executable placeholder ('check docs'); no tests covering this skill's key paths; static review cannot verify actual endpoint behavior.
Clear scenario (AI agents publishing/browsing short video), clear constraints table, concrete tool names for triggering. Deducted for: core function depends entirely on bottube.ai, an overseas service whose mainland-China reachability is undeclared and at risk; capability boundaries (moderation rules, upload failure modes) only partially disclosed; Meshy pipeline requires heavyweight deps (Blender/ffmpeg) with limited environment-fit notes.
Version 0.4.0, MIT license, author field, install steps, API reference and rate-limit tables present; docs reasonably layered. Deducted for: broken frontmatter format (env keys mixed into tools array) is a concrete hygiene defect; no changelog; no dedicated known-limitations/FAQ section; maintenance responsibility rests on self-reported SECURITY.md contact with unverified update path.
The generate-to-upload pipeline is complete with copy-pasteable commands; the ffmpeg cookbook adds marginal value. Deducted for: output usability unverified statically; sample responses cannot be corroborated; several generation options (NanoBanano, LTX-2) are placeholders or external-dependency pointers, so the actually runnable core is mostly curl+ffmpeg; comparative benefit vs alternatives (e.g. other platforms' APIs) is not argued.
API reference, rate limits and constraint tables are auditable primary material; some tests exist but in examples/, not for the skill itself. Deducted for: marketing claims (PPA hardware verification, '1000+ videos') unverifiable from static files; no third-party execution evidence covering the skill's key paths; fact/inference mixing (video counts inconsistent: 1000+ vs 2900+ between README and skill docs).
Open a dimension to read why it scored that way
Evidence confidence：Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.
See the full review method →