← Back to Skills Marketplace
cindulasai

Clawshorts Pkg

by cindulasai · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ⚠ suspicious
91
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clawshorts-pkg
Description
Block YouTube Shorts on Fire TV. Use when asked to check, manage, or configure YouTube Shorts limiting on Buck's Fire TV devices. Triggers on requests like "...
README (SKILL.md)

ClawShorts

YouTube Shorts limiter for Fire TV. Monitors watch time per device and auto-blocks when daily limit is reached.

Invocation

Primary entry point:

~/.openclaw/workspace/skills/clawshorts/scripts/clawshorts.sh \x3Ccommand>

Commands

Command When to use
status Check today's usage, remaining quota, daemon health
reset [IP] Reset today's counter (all devices or specific IP)
start Start the daemon if not running
stop Stop the daemon
history [days] Show watch history (default 30 days)
logs [N] Show last N daemon log lines (default 50)
list List all configured devices
setup \x3CIP> [NAME] First-time setup for a new device
add \x3CIP> [NAME] Add another Fire TV
connect \x3CIP> Connect ADB to device
enable \x3CIP> / disable \x3CIP> Enable/disable a device

Detection Logic

  • Poll interval: 3 seconds via ADB
  • Shorts: ~45% screen width (portrait aspect)
  • Regular video: ~100% screen width
  • Home/browse: no video active
  • Only actual Shorts playback counts toward limit

Data Locations

  • Device config + history: ~/.clawshorts/clawshorts.db (SQLite)
  • Daemon log: ~/.clawshorts/daemon.log
  • LaunchAgent: ~/Library/LaunchAgents/com.fink.clawshorts.plist

Requirements

  • adb (Android platform tools)
  • Python 3
  • Fire TV with ADB debugging enabled
  • shorts symlink at /opt/homebrew/bin/shorts
Usage Guidance
This package appears to implement the advertised YouTube-Shorts limiting functionality (it uses adb to inspect the Fire TV UI, tracks usage in ~/.clawshorts/clawshorts.db, and force-stops the YouTube app when limits are reached). Important things to consider before installing: - Metadata mismatch: the registry lists no required binaries, but the SKILL.md and scripts require Python 3 and adb (Android platform tools). The package will also attempt to create a symlink at /opt/homebrew/bin/shorts and install a LaunchAgent/systemd service — these actions may require elevated permissions or modify your login services. - Persistence: the install path writes files under your home directory and configures autostart (~/Library/LaunchAgents or ~/.config/systemd/user). If you later uninstall, verify those files are removed. - ADB risks: enabling ADB on a Fire TV grants remote control of that device. Only enable ADB on trusted networks and understand that adb connect will open a network-accessible control channel to the device. - Review before running: because the package includes executable scripts that call adb, launchctl/systemctl, and pkill, you should inspect the files locally (they are present in the bundle) and run them in a controlled environment first. If you prefer least privilege, run the daemon manually without installing the auto-start components, or run in an account/container you can easily roll back. - If you want to proceed: ensure adb and Python are installed, read the install/uninstall steps in README/TROUBLESHOOTING, and confirm the created symlink and LaunchAgent are acceptable. If unsure, ask the publisher for a formal install spec and clarification of why registry metadata omitted runtime binary requirements.
Capability Assessment
Purpose & Capability
The name/description (block YouTube Shorts on Fire TV) aligns with the included code: ADB-based daemon, detection logic, and SQLite state. However the registry metadata claims no required binaries/env but the SKILL.md and scripts clearly require adb and Python and expect a symlink /opt/homebrew/bin/shorts — this metadata omission is inconsistent and surprising.
Instruction Scope
The SKILL.md and scripts instruct the agent/user to run local scripts that: connect to devices over ADB, dump UI XML, force-stop apps, create a symlink in /opt/homebrew/bin, write a LaunchAgent plist (~/Library/LaunchAgents) or systemd unit, and manage a local SQLite DB under ~/.clawshorts. All of these actions are coherent with the stated purpose but they give the skill broad control of local system files and persistent startup behavior and require enabling ADB on target devices (which the docs warn about).
Install Mechanism
There is no formal install spec in the registry, yet the package includes many code files and provides manual install steps that write files, create symlinks (potentially requiring sudo), and register LaunchAgents/systemd units. The absence of a declared install mechanism in metadata vs. presence of executable scripts is a packaging/integrity concern — users may be surprised that files will be created and autostart configured.
Credentials
The skill requests no cloud credentials or unrelated environment variables. All data it uses is local (ADB to on‑network Fire TV IPs, local SQLite under ~/.clawshorts). This is proportionate to its functionality. Note: enabling ADB gives the host machine powerful control of the TV device (expected for this use case).
Persistence & Privilege
The skill/installation will create persistent components: a daemon, optional LaunchAgent or systemd unit, and a healthcheck sidecar that can kill/restart the daemon. always:false is set, but installing the skill (via its provided install actions) grants it persistent autostart on the user's account. Users should be aware this will run continuously and can restart/kill processes on the machine.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawshorts-pkg
  3. After installation, invoke the skill by name or use /clawshorts-pkg
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
ClawShorts v1.0.4 Changelog - Introduced SKILL.md with concise description, invocation details, and supported commands. - Documented command-line usage for managing, monitoring, and configuring YouTube Shorts limits on Fire TV devices. - Added device setup, usage tracking, history, and connectivity instructions. - Outlined detection logic and required dependencies.
Metadata
Slug clawshorts-pkg
Version 1.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Clawshorts Pkg?

Block YouTube Shorts on Fire TV. Use when asked to check, manage, or configure YouTube Shorts limiting on Buck's Fire TV devices. Triggers on requests like "... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.

How do I install Clawshorts Pkg?

Run "/install clawshorts-pkg" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Clawshorts Pkg free?

Yes, Clawshorts Pkg is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Clawshorts Pkg support?

Clawshorts Pkg is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clawshorts Pkg?

It is built and maintained by cindulasai (@cindulasai); the current version is v1.0.4.

💬 Comments