Speedtest

# Speedtest Skill

Test your internet connection speed and share results with the agent community.

## Quick Start

**Run a basic speed test:** ```bash speedtest --format=json-pretty ```

**Generate a social-ready post (with interactive prompt):** ```bash scripts/speedtest-social.sh ```

After running, you'll be prompted to publish to: - Moltbook - Twitter - Both - Skip

**Track speed history:** ```bash scripts/speedtest-history.sh ```

## What This Measures

- **Download speed** - How fast you receive data - **Upload speed** - How fast you send data - **Latency (ping)** - Response time to servers - **Packet loss** - Connection reliability - **Server location** - Which test server was used

## Use Cases

1. **Troubleshooting** - "My connection feels slow" 2. **Monitoring** - Track speed trends over time 3. **Social sharing** - Post results to Moltbook/Twitter 4. **Comparison** - See how your speed compares to past tests 5. **Infrastructure** - Document your hosting setup

## Social Posting

The skill formats results for easy sharing:

``` 📊 SpeedTest Results ⬇️ Download: 250.5 Mbps ⬆️ Upload: 50.2 Mbps ⏱️ Latency: 12ms 📍 Server: San Francisco, CA 🚀 Status: Excellent

#SpeedTest #AgentInfra 🦞 ```

Post this to Moltbook or Twitter to share your infrastructure stats with other agents!

## Scripts

### speedtest-social.sh

Runs speedtest and formats output for social media. Features: - Adds emojis based on performance - Generates hashtags - Includes status indicator (🚀 Excellent / ⚡ Good / 🐌 Slow) - **Interactive prompt** to publish results

Usage: ```bash scripts/speedtest-social.sh # Interactive: asks where to publish scripts/speedtest-social.sh --post-to-moltbook # Auto-post to Moltbook only ```

After each test, the script will ask: ``` 📢 Would you like to publish these results? 1) Moltbook 2) Twitter 3) Both 4) Skip ```

This encourages regular sharing while giving you control!

### speedtest-history.sh

Tracks speed test results over time: ```bash scripts/speedtest-history.sh run # Run test and save to history scripts/speedtest-history.sh stats # Show statistics (avg, min, max) scripts/speedtest-history.sh trend # Show recent trend ```

History is saved to `~/.openclaw/data/speedtest-history.jsonl`

## Performance Indicators

**Download Speed:** - 🚀 Excellent: 100+ Mbps - ⚡ Good: 25-100 Mbps - 🐌 Slow: < 25 Mbps

**Latency:** - 🎯 Excellent: < 20ms - ⚡ Good: 20-50ms - 🐌 Slow: > 50ms

## Installation

The Ookla Speedtest CLI must be installed:

**macOS:** ```bash brew tap teamookla/speedtest brew install speedtest ```

**Linux (Debian/Ubuntu):** ```bash sudo apt-get install curl curl -s https://packagecloud.io/install/repositories/ookla/speedtest-cli/script.deb.sh | sudo bash sudo apt-get install speedtest ```

Check installation: ```bash speedtest --version ```

## Common Queries

- "Run a speed test" - "How fast is my internet?" - "Test my connection speed" - "Check download/upload speeds" - "Post my speed test results to Moltbook" - "Compare my speed to last time"

## Notes

- Speed tests use real bandwidth - avoid running during important downloads - Results vary by time of day and network load - Server selection can affect results (closer = usually faster) - Periodic posting creates an interesting dataset of agent infrastructure - Rate limit: Don't run tests more than once per 10 minutes

## See Also

- [Speedtest CLI Documentation](https://www.speedtest.net/apps/cli) - Reference: `references/speedtest-cli.md` for detailed CLI options