ha-user-manual
使用 Home Assistant 插件查询和控制设备，以及独立记录、查阅、整理跨会话共用的用户要求记忆和操作手册。遇到设备称呼、开关灯的范围、默认设置、操作习惯或含糊指令时使用。
Install / Use
npx skills add sakulin2025/SakuBot --skill ha-user-manualInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of ha-user-manual
ha-user-manual scores 61/100 on our quality scale, 4080th of 4,640 Development & Engineering skills we index.
Its SKILL.md is 1.7 KB long, split into 5 sections with 1 code example: moderately detailed.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so ha-user-manual is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-10-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
ha-user-manual compared with similar skills
All 4 of these similar skills score higher than ha-user-manual; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| ha-user-manual (this skill)by sakulin2025 | 61 | 0 | today | SKILL.md |
| taste-skillby Leonxlnx | 100 | 104.0k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 67.0k | 1d ago | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 45.7k | 1d ago | CLAUDE.md |
| algorithmic-artby anthropics | 100 | 177.9k | 35d ago | SKILL.md |
Frequently asked questions
- How do I install ha-user-manual?
- Run
npx skills add sakulin2025/SakuBot --skill ha-user-manual. The install tabs above show the steps for each supported agent. - Which AI agents does ha-user-manual work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is ha-user-manual safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is ha-user-manual still maintained?
- The repository was last updated today, so ha-user-manual is actively maintained.
Skill content
View source on GitHubname: ha-user-manual description: 使用 Home Assistant 插件查询和控制设备，以及独立记录、查阅、整理跨会话共用的用户要求记忆和操作手册。遇到设备称呼、开关灯的范围、默认设置、操作习惯或含糊指令时使用。
Home Assistant 用户要求记忆与操作手册
把插件中的手册当作主人维护的操作知识文档。主人在任何平台、群聊、私聊都能使用同一份手册，不按会话、动作、参数、有效期或次数划分。它帮助理解用户的意思，不是权限审批表。
先理解，再执行
- 查看当前上下文的已授权设备目录及手册。上下文已给出足够信息时直接使用；第一次使用或拿不准时，用
ha_manual(action="read")读取完整手册。 - 结合本次明确指令、手册、设备名字、别名、房间和分组确定目标。本次明确指令优先于长期习惯；不要把明确的临时要求擅自改成长期要求。
- 主人明确说“开灯”“关空调”“调到26度”时，可以直接调用
ha_control。不要求再预览一次或再问一句“确定吗”。只有用户主动要求查看计划时使用preview=true。 - 多台设备同属一个房间或同一照明用途时，“开灯”“关灯”可以指集体操作，不要仅仅因为存在两盏灯就追问哪一盏。优先遵循已记住的习惯；用户明确说左灯或右灯时只操作指定设备。只有手册和上下文都无法消除实质歧义时才简短询问。
- 获取真实 entity_id 后，可在一次
ha_control调用中传入多个entity_ids。对列表执行相同的action和params。涉及不同设置时分别调用，不猜实体 ID，也不把部分成功说成全部成功。
实验室两盏灯的例子
如果用户已要求“开灯/关灯就是实验室的左顶灯和右顶灯同时开关，不用再确认”，将这句话记录到手册。以后用户说“开灯”，查设备目录得到两盏灯的实际 ID，调用：
{
"action": "on",
"entity_ids": ["设备目录中的左顶灯ID", "设备目录中的右顶灯ID"]
}
这里的 ID 是示意，必须替换成当前目录的真实 ID。用户说“只开左灯”时只选左灯，不要套用两盏一起开的习惯。
记住要求，独立于操作设备
- 用户说“记住”“以后默认”“下次不要再问”或纠正既有习惯时，使用
ha_manual(action="append", content="用户的具体要求")保存。保存不访问 HA、不控制设备，不需要先演示或执行一次。 - 需要修正、删除某一条或合并重复要求时，先
read，再用write保存整理后的完整 Markdown 文档，保留其他仍有效的要求。只有用户要求清空时才clear。 - 手册可记设备称呼、房间含义、批量操作习惯、温度或亮度偏好、例外、避免打扰的要求及操作步骤。只记录用户实际表达或确认的信息，不编造习惯、范围或权限。
- “记住开灯时两盏一起开”是记忆请求，不自动开灯；“记住这个习惯，现在也把灯打开”才同时包含记忆与控制请求。
- 保存成功后简短复述记住的要求，不让用户重复确认已明确说过的话。记录在插件页面也可以直接查看和编辑。
名称、状态与接口
light、switch是 HA 技术类型，不等于用途。灯也可能是switch；查询“灯有没有开”优先ha_query(match="灯")，不只筛选domain="light"。display_name优先使用别名。设备目录和手册不代表实时状态；回答当前是否开启、温度或湿度时调用ha_query，不要引用旧状态作为当前状态。- 手册本身不会触发后台操作或改变房间、实体的启用及可控制策略。修改这些配置使用原有主人初始化工具。
- 权限直接使用 SakuBot 的主人身份；手册读取和修改仅限主人。不要通过新建会话或重新发送同样命令绕过用户意图。
Related Skills
taste-skill
104.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
67.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
45.7kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.