关于 home-assistant-dashboards-cards
用于创建或编辑 Home Assistant 仪表盘与卡片的技能,面向通过 ha-mcp 操作仪表盘的用户。它提供从实体发现、卡片配置到仪表盘资源管理的工作步骤和注意事项。
主要功能
- 01发现实体 ID
- 02列出并查找仪表盘卡片
- 03查询卡片类型与文档
- 04更新仪表盘配置和元数据
- 05管理仪表盘资源及 HACS 卡片
适用场景
- 01新建 Home Assistant 仪表盘
- 02定位并编辑现有卡片
- 03查找自定义卡片并管理资源
MCP 相关
该技能列出 ha-mcp 的工具,用于发现实体、读取和更新仪表盘,以及管理卡片与资源。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bradsjm/ hassio-addons --skill home-assistant-dashboards-cards安装后在 Claude Code 中输入/home-assistant-dashboards-cards确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/CARD_SCHEMA_GUIDE.mdCUSTOM_RESOURCES.mdDESIGN_PATTERNS.md详细介绍
Home Assistant 仪表板与卡片
工作流
- 确定要创建新仪表板还是编辑现有仪表板。
- 如果是编辑,先定位目标卡片,并使用当前的
config_hash转换配置。 - 除非需要自定义卡片,否则使用内置卡片。
- 在配置卡片前,先查找实体 ID。
- 提供精简、有效的仪表板代码片段,或通过工具进行更改。
工具一览(ha-mcp)
- 查找实体:
ha_get_overview、ha_search_entities - 列出/获取仪表板:
ha_config_get_dashboard - 查找卡片:
ha_dashboard_find_card - 卡片文档:
ha_get_card_types、ha_get_card_documentation - 更新配置:
ha_config_set_dashboard、ha_config_update_dashboard_metadata - 资源:
ha_config_list_dashboard_resources、ha_config_set_dashboard_resource、ha_config_set_inline_dashboard_resource、ha_config_delete_dashboard_resource - HACS 卡片:
ha_hacs_info、ha_hacs_list_installed、ha_hacs_search、ha_hacs_download
注意事项
- 仪表板 URL 路径必须包含连字符。
- 策略仪表板必须先“接管”才能编辑。
- 更改资源后可能需要强制刷新。
- 核心 Lovelace YAML 不会评估 Jinja 模板。
参考资料
所有参考文件均相对于此 SKILL.md 文件所在的位置。
- 设计模式:
references/DESIGN_PATTERNS.md - 卡片架构指南:
references/CARD_SCHEMA_GUIDE.md - 自定义资源:
references/CUSTOM_RESOURCES.md
评论
支持 Markdown