← Back to Skills Marketplace
219
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install dokidoki
Description
Control interactive BLE devices (scan/connect/playback/timeline) from terminal.
README (SKILL.md)
DokiDoki CLI
Use doki to control interactive BLE devices from the terminal.
Quick Start
doki scan- Scan for BLE devices (auto-starts daemon)doki connect DK-META2- Connect to device (auto-starts daemon)
Common Tasks
Daemon Management
doki start- Start background daemondoki stop- Stop background daemondoki status- Check daemon and connection status
Device Connection
doki scan- Scan for BLE devicesdoki connect [name]- Connect to device (default: DK-META2)doki disconnect- Disconnect from device
Timeline Playback
doki player play [audio] \x3Ctimeline.json>- Play timeline with optional audio syncdoki player pause- Pause playback (stops device)doki player resume- Resume playback
Direct Device Control
doki action linear 50- Set linear to 50%doki action rotary -30- Set rotary to -30 (reverse)doki action vibration 80- Set vibration to 80%doki action pause- Immediately stop all device actions
Timeline Format
Timeline files are JSON files defining device actions at specific timestamps:
{
"duration": 180.5,
"actions": [
{"timestamp": 0.0, "type": "VIBRATION", "value": 50},
{"timestamp": 5.5, "type": "LINEAR", "value": 30},
{"timestamp": 10.0, "type": "ROTARY", "value": -50}
]
}
Action Types
| Type | Value Range | Description |
|---|---|---|
LINEAR |
0-100 | Linear/stroke motion intensity |
ROTARY |
-100 to 100 | Rotation speed (negative=reverse) |
VIBRATION |
0-100 | Vibration intensity |
Notes
- Requires Node.js 18+ and Bluetooth Low Energy (BLE) support
- Supported audio formats: MP3, AAC/M4A, WAV, FLAC, OGG, AIFF
- Audio playback requires
ffplay(Linux/Windows) orafplay(macOS) - Logs are written to
/tmp/dokidoki.log
Usage Guidance
This skill appears to be an instruction wrapper around a CLI ('doki') for controlling BLE devices. Before installing or using it: 1) Verify the 'doki' binary/package source (the SKILL.md suggests @tryjoy/dokidoki on npm) and confirm the publisher is trustworthy; 2) Installing globally with npm requires elevated permissions on some systems—avoid installing packages from unknown authors as root; 3) The tool will access Bluetooth hardware and audio playback utilities (ffplay/afplay) and writes logs to /tmp/dokidoki.log—consider whether that log may contain sensitive info and whether your system's Bluetooth policy allows this; 4) If you want extra assurance, inspect the npm package contents (or its GitHub repo) before installing to ensure no unexpected network or filesystem behavior. Overall the skill is coherent with its purpose, but standard supply-chain caution is recommended.
Capability Analysis
Type: OpenClaw Skill
Name: dokidoki
Version: 1.0.2
The skill is a standard CLI wrapper for the '@tryjoy/dokidoki' npm package, designed to control interactive BLE devices. The SKILL.md file provides legitimate instructions for device scanning, connection management, and timeline playback without any evidence of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
Purpose & Capability
The skill describes controlling BLE devices and only requires the 'doki' CLI plus optional audio tools; these needs match the stated functionality.
Instruction Scope
SKILL.md only instructs the agent to run doki commands and read timeline JSON files (expected for playback). It does not ask to read unrelated system files, credentials, or transmit data to external endpoints.
Install Mechanism
The SKILL.md includes an npm global install suggestion (@tryjoy/dokidoki). Installing a global npm package is a normal way to get the binary but carries moderate supply-chain risk — verify the package name/owner on the npm registry before installing.
Credentials
No environment variables, credentials, or config paths are required. The only system resources referenced are BLE hardware, audio playback tools (ffplay/afplay), and a log file in /tmp, which are proportionate to a BLE playback CLI.
Persistence & Privilege
Skill is not always-enabled and does not request elevated platform privileges or modify other skills' configs. Autonomous invocation is allowed by default (normal).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dokidoki - After installation, invoke the skill by name or use
/dokidoki - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Removed the file `_meta.json` from the project.
- No changes to documentation or user-facing features.
v1.0.1
- No user-visible changes in this release.
- Version bump only; documentation and features remain unchanged.
v1.0.0
Initial public release of dokidoki CLI.
- Control interactive BLE devices from the terminal using simple commands.
- Scan, connect, and manage connections to BLE devices.
- Playback timelines with optional audio sync; supports various audio formats.
- Directly control device actions (linear, rotary, vibration) from the CLI.
- Manage the background dokidoki daemon (start/stop/status).
- Provides detailed documentation for command usage and timeline file format.
Metadata
Frequently Asked Questions
What is dokidoki?
Control interactive BLE devices (scan/connect/playback/timeline) from terminal. It is an AI Agent Skill for Claude Code / OpenClaw, with 219 downloads so far.
How do I install dokidoki?
Run "/install dokidoki" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is dokidoki free?
Yes, dokidoki is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does dokidoki support?
dokidoki is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created dokidoki?
It is built and maintained by tryjoy (@lovappencava); the current version is v1.0.2.
More Skills