home-assistant-esphome
All reference and script files are relative to the location of this SKILL.md file.
Works with
Installation Guide
How to use home-assistant-esphome on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your machine
- ›Node.js 16+ with npm — verify with
node --version - ›Active project directory where you want to add
home-assistant-esphome
Run the install command
Execute the skills CLI command in your project's root directory to begin installation:
Fetches home-assistant-esphome from bradsjm/hassio-addons and configures it for Cursor.
Select Cursor when prompted
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate home-assistant-esphome. Access via /home-assistant-esphome in your agent's command palette.
Security Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Documentation
ESPHome + Home Assistant
Workflow
- Identify the task: new device/adopt, offline troubleshooting, or YAML feature changes.
- For HA-side validation, discover ESPHome entities and map to devices before changing names.
- For YAML changes, edit in ESPHome Device Builder (UI-first), validate, then install (USB first flash, OTA thereafter).
- When building automations from ESPHome entities, follow
home-assistant-best-practicesfor automation patterns.
HA-side discovery (common)
- Check integration state:
ha_get_integration(query="esphome") - Find entities by name or area:
ha_search_entities(query="kitchen", limit=50) - Map entity to device:
ha_get_device(entity_id="...")
Local helper (bundled)
All reference and script files are relative to the location of this SKILL.md file.
- Generate a new base64 32-byte key:
- Raw:
python3 scripts/gen_esphome_noise_psk.py - YAML block:
python3 scripts/gen_esphome_noise_psk.py --yaml
- Raw:
References
- Core resources and docs:
references/resources.md - YAML snippets and naming patterns:
references/snippets.md - Troubleshooting:
references/troubleshooting.md - HA config flow specifics:
references/ha-config-flow.md
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale