jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Migrate an existing Home Assistant custom integration into the blueprint's structure and tooling without breaking the installations already running it. Use when asked to "import my integration", "migrate my existing integration into the blueprint", "adopt the blueprint in my repository", "move my custom component…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Turn this freshly initialised blueprint into a working integration for one concrete device, service or computed source — decide the manifest classification, write the API client if there is one, shape the coordinator payload, keep or delete each example entity platform, and get the first end-to-end run green. Use when…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Maintain the agent skill set that this blueprint template ships to downstream integration repositories. Use when asked to "add a skill", "update the skills", "this skill is out of date", "split this skill", "remove a skill", "the skills disagree with the instructions", or after bumping the pinned Home Assistant…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Use this repository's development tooling correctly — the script/ validation and formatting commands, the fix-versus-check distinction, hassfest, adding a Python dependency in both manifest.json and requirements.txt, extending scripts with pre/post hook scripts, devcontainer environment variables, and template sync…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Handle any change to this Home Assistant custom integration that could break existing installations — unique IDs and entity IDs, config entry data, config options, service actions, state values, units, device classes, the minimum Home Assistant version, or removing entities and devices. Use when asked to "rename"…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Work on the Home Assistant config flow of this custom integration — the setup UI, options flow, reauthentication, reconfigure, discovery (zeroconf, dhcp, ssdp, bluetooth, usb, mqtt, homekit), subentries, unique IDs, and config entry version migration. Use when asked to "add a config option", "add a setting", "ask the…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Diagnose and fix runtime problems in this Home Assistant custom integration — entities showing "unavailable" or "unknown", stale data, the integration failing to set up, "Config entry not ready", repeated reauth prompts, coordinator update failures, timeouts, or blocking-call warnings. Use when asked to "debug", "why…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Add or change a Home Assistant entity platform or an individual entity in this custom integration — sensor, binarysensor, switch, button, number, select, fan, climate, cover, light, lock, and friends. Use when asked to "add a sensor", "add a new entity", "add a platform", "expose as an entity", "add an entity to the…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Interview the developer until the requirements of a change are actually settled, before any code is written. Use when asked to "grill me", "roast me", "interview me", "ask me what you need to know", "I want to build an integration for ", "let's add ", "challenge my idea", or whenever a request names a goal but none of…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Work through a backlog of GitHub issues on this repository — categorize, then walk bugs and feature requests one at a time, fixing approved ones on a branch through a pull request instead of committing straight to main. Use when asked to "triage my issues", "go through the issue backlog", "work through the issues"…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Verify that Home Assistant APIs used in this custom integration are current, and replace deprecated ones. Use when a DeprecationWarning or "will be removed in HA Core X.Y" appears in logs or tests, when tests fail because warnings are errors, when asked to "modernize", "update to the latest HA version", "fix…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Plan a large change to this Home Assistant custom integration before writing code, or record an architectural decision. Use when asked to "create a plan", "plan this feature", "how should we approach", "propose an architecture", "write an ADR", "document this decision", "should we use library X or write our own…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Perform a structured quality review of this Home Assistant custom integration, either as a full audit or scoped to a diff. Use when asked to "review the integration", "audit the code", "check quality scale", "are we bronze/silver/gold", "is this ready to release", "review my changes", "what's missing before…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Cut a release of this Home Assistant custom integration, or prepare the commits that feed it. Use when asked to "release", "cut a version", "bump the version", "prepare release notes", "what will the next version be", "write a commit message", "why didn't release-please pick this up", or when reviewing whether a…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Add, change, or remove a Home Assistant service action (also called a "service" or "action") in this custom integration. Use when asked to "add a service", "add an action", "expose X as a service call", "add a service that returns data", "make this callable from an automation", or when editing services.yaml, the…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Write, fix, or extend automated tests for this Home Assistant custom integration using pytest and pytest-homeassistant-custom-component. Use when asked to "add tests", "write a test", "the tests fail", "improve coverage", "add a regression test", "test the config flow", "update snapshots", or when a behavioural change…
jpawlowski/hacs.integration_blueprint
Skill Claude CodeCodex
Add or fix user-facing strings for this Home Assistant custom integration — translations/en.json and other languages, icons.json, entity names and states, config flow labels and errors, service action descriptions, exception messages, and repair issue text. Use when asked to "update translations", "add a translation…
jpawlowski/hacs.integration_blueprint
Command Claude Code
Triage/fix the GitHub issue backlog via branch + PR, with auto-merge on green CI for this session.
jpawlowski/hacs.integration_blueprint
Command Claude Code
Cut a release: follow the ha-release skill's procedure end to end.
jpawlowski/hacs.integration_blueprint
Hook Claude Code
Runs before the agent uses a tool for Bash, shell and exec_command tool calls, executing pre-push-check.sh via bash with --show-toplevel. From jpawlowski/hacs.integration_blueprint.
jpawlowski/hacs.integration_blueprint
Hook Claude Code
Runs after a tool call finishes for Edit, Write and MultiEdit tool calls, executing remind-dependency-sync.sh via bash with --show-toplevel. From jpawlowski/hacs.integration_blueprint.
jpawlowski/hacs.integration_blueprint
Settings file Claude Code
Agent settings declaring 2 hook events (PreToolUse, PostToolUse).
jpawlowski/hacs.integration_blueprint
Instructions file CodexOpenCode
Instructions for jpawlowski/hacs.integration_blueprint, covering ai agent instructions, which repository is this?, project overview, where the rules live and routing table.
jpawlowski/hacs.integration_blueprint
Instructions file
Instructions for jpawlowski/hacs.integration_blueprint, covering claude code instructions and how the pieces reach claude code.