AI Skill
Use AI Skill to let AI assistants directly control your Dot. devices.
What is Dot Skill?
Dot Skill is an open-source tool that allows AI assistants to interact with your Dot. devices through natural language commands. No need to manually write API requests—just tell the AI what you want to do.
Features
- Plug and Play - Control devices through natural language after installation
- Text Push - Display specified text content on the device
- Image Push - Push images to the device for display
- Canvas Push - Send data and windowData to draw a fully custom screen
- Task Alias - Give text, image, and canvas items an easy-to-recognize task name
- Status Query - Check device battery level, network status, and other information
- Content Switching - Switch to the next content
- Helper Scripts - Python scripts provided for automation
Supported Platforms
| Platform | Status | Integration path |
|---|---|---|
| Codex | Supported | Install as a Codex plugin with this repository's .agents/plugins/marketplace.json and plugins/dot-skill bundle |
| OpenAI GPT Actions | Supported via schema | Import openapi/dot-openapi.yaml and configure Bearer authentication |
| Claude / MCP clients | Planned | Use the OpenAPI schema today; a remote MCP server can be added later |
| Cursor and skill-compatible agents | Supported as skill docs | Install skills/dot-device-openapi and/or skills/dot-canvas-designer, or use this repository as context |
| MCP Registry | Planned | Publish server metadata after a Dot MCP server exists |
Installation
Option 1: Install as a Codex plugin
Add the dot_skill repository as a Codex marketplace:
codex plugin marketplace add git@github.com:MindReset/dot_skill.gitThen install the plugin:
codex plugin add dot-skill@mindreset-dot-skillStart a new Codex thread after installation so Codex can load the plugin's skills.
Option 2: Install with npx skills add
npx skills add https://github.com/MindReset/dot_skill.gitInstall only the device interaction skill:
npx skills add https://github.com/MindReset/dot_skill.git --skill dot-device-openapiInstall only the Canvas designer skill:
npx skills add https://github.com/MindReset/dot_skill.git --skill dot-canvas-designerOption 3: Manual Install
mkdir -p ~/.agents/skills
ln -sfn /path/to/dot_skill/skills/dot-device-openapi ~/.agents/skills/dot-device-openapi
ln -sfn /path/to/dot_skill/skills/dot-canvas-designer ~/.agents/skills/dot-canvas-designerRestart your agent after manual installation. dot-openapi remains as a compatibility router for older installs; new installs should use dot-device-openapi and dot-canvas-designer.
Quick Start
Configure Environment Variables
export DOT_API_KEY="dot_app_your_api_key"Start Using
After installation, you can simply say to your AI assistant:
- "Show 'Meeting starts at 3 PM' on device ABCD1234ABCD"
- "Show 'Meeting starts at 3 PM' on device ABCD1234ABCD and name it Meeting Reminder"
- "Check my device status"
- "Switch to the next content"
Task Alias
If you create multiple text, image, or canvas items on the same device, you can give each one a task alias so it is easier to identify in the device task list. Dot Skill passes this name when pushing text, image, or canvas content. If you do not provide one, the existing name is preserved; if you explicitly ask to clear the name, the alias is removed.
Related Links
Did this solve your problem?
Join our community