homebridge-developer

Implement Homebridge plugin patterns for Bose SoundTouch platforms with Jest testing.

Updated Dec 23, 2024
One-click install
npx skills add https://github.com/forktrucka/homebridge-soundtouch-speaker --skill homebridge-developer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homebridge-developer
Source: https://github.com/forktrucka/homebridge-soundtouch-speaker/tree/main/.claude/skills/homebridge-developer
Command: npx skills add https://github.com/forktrucka/homebridge-soundtouch-speaker --skill homebridge-developer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build, debug, and safely evolve the Homebridge SoundTouch plugin without breaking accessory caching, discovery, configuration, or verified-plugin compliance.

Core Features & Use Cases

  • Platform lifecycle guidance: Manage dynamic platform setup, cached accessory reuse, deterministic UUIDs, and stale accessory pruning.
  • Characteristic and service wiring: Implement HomeKit service and characteristic handlers with proper get, set, refresh, and HAP error behavior.
  • Configuration and testing support: Keep config transforms, schema files, and Jest tests aligned so changes remain predictable and valid.
  • Use cases: Add a new HomeKit control, fix accessories that do not appear in Home app, diagnose discovery failures, or troubleshoot volume and power behavior.

Quick Start

Ask for help with a specific Homebridge SoundTouch change and include the affected files, the observed device behavior, and any relevant error messages.

Frequently Asked Questions about homebridge-developer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Homebridge SoundTouch accessories that do not appear in the Home app?

Fix missing Homebridge SoundTouch accessories by checking dynamic platform discovery, verifying accessory caching, and ensuring stable UUIDs are preserved during the platform lifecycle to maintain persistent Home app visibility.

How do I implement HomeKit characteristic get and set handlers for a Homebridge plugin?

Implement HomeKit characteristic handlers by wiring get, set, and refresh logic with proper HAP error handling to ensure reliable communication between Homebridge accessories and the Home app.

How does accessory caching work in a Homebridge dynamic platform?

Accessory caching in a Homebridge dynamic platform preserves accessory state across restarts by reusing cached accessories, maintaining deterministic UUIDs, and pruning stale accessories during platform lifecycle setup.

Can I use Jest to test a Homebridge SoundTouch plugin?

Use Jest to test Homebridge SoundTouch plugins by validating configuration transforms, config schema parity, and characteristic behavior, ensuring changes remain predictable and verified-plugin compliant.

What is the best way to add a new HomeKit control to a Homebridge SoundTouch dynamic platform?

Add a new HomeKit control to a SoundTouch dynamic platform by wiring the service and characteristic handlers, updating config schema files, and aligning Jest tests to maintain verified-plugin compliance.

Why does my Homebridge SoundTouch volume or power control behave inconsistently?

Inconsistent SoundTouch volume or power behavior often stems from improper characteristic refresh logic or unhandled HAP errors during get and set operations within the platform lifecycle.