badkid90s/spreado/spreado-skill

Spreado Skill

This skill provides all the necessary knowledge and workflows to install, configure, and use the spreado CLI tool for multi-platform video distribution.

🚀 Quick Start Workflow

1. Installation

Depending on the user's environment, choose the best installation method.

• Trigger: "Install spreado", "How to set up spreado?"
• Guidance: See installation.md for binary download links and Python-based installations (uv, pip).

2. Authentication

Before first use, the user must log in to each target platform.

• Trigger: "Connect my Douyin account", "Login to platforms"
• Action: spreado login <platform>

3. Verification

Checking if platforms are ready for upload.

• Trigger: "Check status", "Are my cookies valid?"
• Action: spreado verify all --parallel

4. Uploading Content

Publishing videos with metadata.

• Trigger: "Post this video", "Upload to all platforms"
• Action: Use spreado upload with appropriate flags.
• Reference: See cli_usage.md for detailed command syntax.

🛠️ Scripts & Automation

The skill includes helper scripts to speed up development:

• [example.py](scripts/example.py): A template showing how to use the Spreado Python API for programmatic uploads.

📋 Common Scenarios

Case: Posting to multiple platforms simultaneously

1. Verify status for all platforms.
2. If any are invalid, request the user to run the login command.
3. Perform a parallel upload: spreado upload all --video video.mp4 --title "My Title" --parallel

Case: Using without Python

Redirect users to download the official binaries for their OS (Windows/macOS/Linux). See installation.md.

🔧 Advanced Features

• Scheduling: Post videos at a specific time using --schedule.
• Custom Cookies: Manage multiple accounts by specifying --cookies path.
• API Access: Use the Python API for programmatic integration (see project README).