clawshorts
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 "check shorts quota", "reset shorts", "shorts status", "how much shorts watched today", "stop shorts limiter", "start shorts limiter".
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/cindulasai/clawshorts-pkgWhat This Skill Does
ClawShorts is a specialized monitoring and enforcement agent designed for Amazon Fire TV devices. Its primary function is to track the viewing habits of users on the YouTube application specifically focusing on 'Shorts'. Since Shorts can be highly addictive and time-consuming, ClawShorts provides a granular method to enforce screen time limits. The agent functions by continuously polling the Fire TV device via Android Debug Bridge (ADB) every three seconds. It uses image-based detection logic to identify when a user is watching a Short versus standard long-form video or browsing the home screen. By calculating the aspect ratio (Shorts typically occupy approximately 45% of the screen width), it accurately logs active watch time. Once a pre-defined daily limit is reached, the daemon can be configured to restrict further access to the content.
Installation
To install the ClawShorts skill on your OpenClaw environment, ensure you have Python 3 and the Android Platform Tools (adb) installed on your system. Use the following command in your terminal:
clawhub install openclaw/skills/skills/cindulasai/clawshorts-pkg
After installation, you must ensure the symlink /opt/homebrew/bin/shorts points to the correct executable. For your first device, navigate to the terminal and run ~/.openclaw/workspace/skills/clawshorts/scripts/clawshorts.sh setup <IP_ADDRESS> <DEVICE_NAME>. This will register the device in the SQLite database located at ~/.clawshorts/clawshorts.db and initiate the monitoring daemon.
Use Cases
This skill is ideal for parents looking to curb social media consumption on living room devices or individuals seeking to practice better digital hygiene. Use ClawShorts to audit how many hours are spent doom-scrolling, to reset quotas if a child has completed their chores, or to view long-term trends in usage through the history command.
Example Prompts
- "OpenClaw, how much time have the kids spent watching YouTube Shorts today on the living room Fire TV?"
- "I need to reset the Shorts quota for the bedroom TV, can you clear that for me?"
- "Is the ClawShorts daemon currently running? Check the status of all my connected devices."
Tips & Limitations
The detection logic relies on screen width analysis; therefore, it is highly accurate but may occasionally misidentify content if the YouTube UI layout changes significantly after an app update. Always ensure ADB debugging is enabled on your Fire TV, as connectivity issues will cause the daemon to report errors in the log file at ~/.clawshorts/daemon.log. If you find the agent is not blocking content, verify that the com.fink.clawshorts.plist LaunchAgent is correctly loaded.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-cindulasai-clawshorts-pkg": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, code-execution