English | 中文

AI-powered development skills for building TuyaOpen hardware projects faster with Cursor IDE. Each skill teaches the AI assistant how to handle a specific part of the TuyaOpen development workflow — from environment setup to device debugging.

Skills are structured knowledge files (SKILL.md) that give AI coding assistants deep, contextual understanding of specific tools, frameworks, and workflows. When loaded into Cursor IDE, the assistant can:

• Set up the TuyaOpen development environment automatically
• Build, flash, and monitor firmware with correct parameters
• Navigate Kconfig dependencies and board configurations
• Diagnose device errors from serial logs
• Follow TuyaOpen coding standards and security practices

The skills cover the complete TuyaOpen development lifecycle:

flowchart LR
    envSetup["1. env-setup"] --> projectConfig["2. project-config"]
    projectConfig --> build["3. build"]
    build --> codeCheck["code-check"]
    build --> flashMonitor["4. flash-monitor"]
    flashMonitor --> deviceAuth["device-auth"]
    flashMonitor --> devLoop["5. dev-loop"]
    devLoop -->|"fix & rebuild"| build
    projectConfig --> addBoard["add-board"]

Typical flow: Set up environment → Create/configure project → Build → Flash to device → Monitor logs → Analyze & iterate.

Cursor automatically loads skills from the following directories:

Install the skill for this project: https://github.com/tuya/TuyaOpen-dev-skills.git

Copy the skills/tuyaopen directory into your TuyaOpen project as .agents/skills/:

git clone https://github.com/tuya/TuyaOpen-dev-skills.git
mkdir -p /path/to/TuyaOpen/.agents/skills
cp -r TuyaOpen-dev-skills/skills/tuyaopen /path/to/TuyaOpen/.agents/skills/tuyaopen

Create a symbolic link so skills stay in sync with this repo:

git clone https://github.com/tuya/TuyaOpen-dev-skills.git
mkdir -p /path/to/TuyaOpen/.agents
ln -s /path/to/TuyaOpen-dev-skills/skills/tuyaopen/ /path/to/TuyaOpen/.agents/skills/tuyaopen

Copy only the skills you need:

mkdir -p /path/to/TuyaOpen/.agents/skills/tuyaopen
cp -r TuyaOpen-dev-skills/skills/tuyaopen/build/ /path/to/TuyaOpen/.agents/skills/tuyaopen/
cp -r TuyaOpen-dev-skills/skills/tuyaopen/env-setup/ /path/to/TuyaOpen/.agents/skills/tuyaopen/

TuyaOpen-dev-skills/
├── README.md
├── README_zh.md
├── LICENSE
└── skills/
    └── tuyaopen/
        ├── env-setup/        SKILL.md + scripts/{check_env.sh,.bat,.ps1}
        ├── build/            SKILL.md + references/KCONFIG_GUIDE.md
        ├── project-config/   SKILL.md + references/TOS_COMMANDS.md
        ├── code-check/       SKILL.md + scripts/check_files.py
        ├── add-board/        SKILL.md + references/BOARD_LAYERS.md
        ├── dev-loop/         SKILL.md + scripts/build_run.py + references/ERROR_CODES.md
        ├── device-auth/      SKILL.md + references/PROVISIONING.md
        └── debug-helper/     SKILL.md + scripts/monitor_helper.py

Each skill follows the Agent Skills standard:

• SKILL.md — concise core instructions loaded automatically by the agent
• references/ — detailed documentation loaded on demand for context efficiency
• scripts/ — executable scripts the agent can run directly

• TuyaOpen — Main SDK repository
• TuyaOpen Documentation — Official docs
• Tuya IoT Platform — Cloud platform for device management
• Cursor IDE — AI-powered code editor

Contributions are welcome! To add or improve a skill:

1. Fork this repository
2. Edit or create a SKILL.md in skills/<skill-name>/
3. Follow the YAML front-matter format (name, description, license, compatibility)
4. Keep SKILL.md concise — move detailed reference material to references/
5. Add agent-executable scripts to scripts/ when automatable workflows exist
6. Submit a Pull Request

This project is licensed under the Apache License 2.0.