ha-blueprint-scaffold

ha-blueprint-scaffold is a skill for Claude Code from nolte/claude-home-assistant. It costs 180 tokens per session (1,753 once invoked), scanned A, original, MIT.

A guided tool for creating one Home Assistant blueprint, which is a reusable YAML recipe for an automation, script, or template. It gathers the requirements and sends the drafting and validation work through a defined review process.

In plain words
What is it for?
Use it to create and check blueprints for Home Assistant automations, scripts, or templates.
Why use it?
It helps turn an automation idea into a self-contained file that follows Home Assistant’s blueprint rules.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the claude-home-assistant plugin — 45 skills, 11 agents shipped together

Good fit Use it to create and check blueprints for Home Assistant automations, scripts, or templates.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/nolte/claude-home-assistant/ha-blueprint-scaffold
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add nolte/claude-home-assistant --skill ha-blueprint-scaffold
Clone the repo
git clone --depth 1 https://github.com/nolte/claude-home-assistant

Made for: Claude Code.

Or install claude-home-assistant, the plugin that ships this one along with the rest of its 45 skills, 11 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ha-blueprint-scaffold

README.md
[![agentmods](https://agentmods.dev/badge/skills/nolte/claude-home-assistant/ha-blueprint-scaffold/github.svg)](https://agentmods.dev/skills/nolte/claude-home-assistant/ha-blueprint-scaffold)
Your own site
<a href="https://agentmods.dev/skills/nolte/claude-home-assistant/ha-blueprint-scaffold"><img src="https://agentmods.dev/badge/skills/nolte/claude-home-assistant/ha-blueprint-scaffold/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ha-blueprint-scaffold

Your own site · 80×15
<a href="https://agentmods.dev/skills/nolte/claude-home-assistant/ha-blueprint-scaffold"><img src="https://agentmods.dev/badge/skills/nolte/claude-home-assistant/ha-blueprint-scaffold.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 180 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,753 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00180 $0.01753
Opus 5 $0.00090 $0.00877
Sonnet 5 $0.00036 $0.00351
Haiku 4.5 $0.00018 $0.00175

Measured 11d ago against content hash 790c8cc8425a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

ha-blueprint-scaffold scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ha-blueprint-scaffold/SKILL.md · 98 lines

How it starts

The opening of the file, as written. The whole thing — 98 lines — stays where its author put it; the contents beside it link to each section on GitHub.

HA Blueprint Scaffold

Spec: spec/claude/ha-blueprint-scaffold/en.md (EN canonical) / spec/claude/ha-blueprint-scaffold/de.md (DE translation).

This skill is the entry point for creating a blueprint. It does not generate the YAML itself — it gathers parameters, runs a pre-flight, and dispatches the ha-blueprint-author agent, which owns the draft → validate → iterate loop and the conformance report against spec/ha/blueprint-patterns/en.md.

Why this is a skill, not an agent

  • Orchestrator role (decisive): the procedure gathers intent interactively, runs the pre-flight, and then dispatches the ha-blueprint-author agent for the heavy authoring — per skill-vs-agent, the orchestrator in the hybrid pattern is always a skill.
  • Mid-flow interactivity: blueprint intent (domain, inputs, trigger shape) is elicited from the operator before any file exists; that dialogue lives in the main conversation.
  • Counter-dimension considered: the YAML authoring itself is self-contained (agent bias) — which is exactly why it is delegated to the sibling agent instead of making this wrapper an agent.

When this skill activates

Use this skill when the user wants to create one Home Assistant blueprint (automation, script, or template) from a described intent — typically to package a reusable automation for sharing or for their own home.

When NOT to activate

  • scaffolding a Python custom integration → ha-integration-scaffold
  • scaffolding a Lovelace card → ha-lovelace-card-scaffold
  • defining an integration service → ha-service-definition-add
  • importing, deploying, or pushing a blueprint into a running HA instance → out of scope (generation only)

Hard rules

  1. Never generate the blueprint inline. The ha-blueprint-author agent is the sole generation path; this skill gathers inputs, pre-flights, dispatches, and relays. Do not rebuild the agent's loop here.
  2. Intent is mandatory. Without a described intent there is no dispatch. Everything else may fall back to a documented default.
  3. Never overwrite an existing blueprint. If the resolved path already exists, abort with the path quoted. Collision is a user-disambiguation problem.
  4. Never silently default. When the user is silent on domain, target_dir, author, or source_url, use the documented defaults — but state every default in the dispatch and in the relayed report.
  5. One blueprint, one domain, one run. No multi-blueprint batches, no Python, no live-HA import.
  6. Verify HA internals against the official docs. Don't reproduce HA API signatures, lifecycle hooks, conventions, or schemas from memory — when uncertain, consult the official docs before generating or relying on it: Developer docs developers.home-assistant, architecture/blueprint/YAML docs home-assistant.io (see spec/ha/upstream-docs-verification/en.md).

Read the full file on GitHub · 98 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 98 lines · 180 tokens per session scan A 790c8cc8425a

Subscribe to this mod's changes

ha-blueprint-scaffold is a skill published in the GitHub repository nolte/claude-home-assistant (1 stars, last pushed 1mo ago), licensed MIT. It adds 180 tokens to every session and 1,753 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

embedded-iot

Embedded systems firmware, microcontrollers (ESP32, STM32, Arduino, Raspberry Pi), RTOS (FreeRTOS, Zephyr), IoT protocols (MQTT, CoAP, BLE), bare-metal C/C++, and hardware peripheral interfaces (I2C, SPI, UART, GPIO). Use when developing firmware, working with microcontrollers, or building IoT devices.

travisjneuman/.claude · 80 tokens

spark-environment-setup

Set up a working ML training/inference environment on NVIDIA DGX Spark (GB10, aarch64, CUDA 13). Use when installing PyTorch/Unsloth/TRL/vLLM on DGX Spark, hitting libcudart or wheel-ABI errors on aarch64, or choosing between NGC containers and bare pip installs.

wshobson/agents · 76 tokens

spark-training-gotchas

Preflight and diagnose the ten known failure modes for ML training on NVIDIA DGX Spark. Use when a training run on DGX Spark fails to start, OOMs below the 128GB limit, slows down mid-run, or before any multi-hour training job on GB10.

wshobson/agents · 63 tokens

security-compliance

Guides security professionals in implementing defense-in-depth security architectures, achieving compliance with industry frameworks (SOC2, ISO27001, GDPR, HIPAA), conducting threat modeling and risk assessments, managing security operations and incident response, and embedding security throughout the SDLC.

sangrokjung/claude-forge · 56 tokens

stride-analysis-patterns

Apply STRIDE methodology to systematically identify threats. Use when analyzing system security, conducting threat modeling sessions, or creating security documentation.

sangrokjung/claude-forge · 30 tokens

review-loop

Run the adversarial verification loop — implement, then hand the change to a fresh checker that did not write it, fix what it finds, and re-dispatch until APPROVE. Use before claiming any behavioural change is done, and on requests like "review loop", "adversarial review", "independent review", "get this verified"…

sangrokjung/claude-forge · 100 tokens