Update Agent Instructions
Agent Buildingupdate-agent-instructionsUpdate Agent Instructions is an Agent Skill for agent building published in the home-assistant/home-assistant.io repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use this if the user wants to update the agent instructions for the Home Assistant website.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/home-assistant/home-assistant.io/blob/HEAD/.claude/skills/update-agent-instructions/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/update-agent-instructions, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Update Agent Instructions
Update the agent instructions for the Home Assistant website.
Review .github/copilot-instructions.md against these current home-assistant.io style-guide sources:
./source/_integrations/_integration_docs_template.markdownhttps://raw.githubusercontent.com/home-assistant/developers.home-assistant/master/docs/documenting/integration-docs-examples.mdhttps://raw.githubusercontent.com/home-assistant/developers.home-assistant/master/docs/documenting/standards.mdhttps://raw.githubusercontent.com/home-assistant/developers.home-assistant/master/docs/documenting/general-style-guide.mdhttps://raw.githubusercontent.com/home-assistant/developers.home-assistant/master/docs/documenting/yaml-style-guide.mdhttps://raw.githubusercontent.com/home-assistant/frontend/refs/heads/dev/gallery/src/pages/brand/personality.markdown
Update only .github/copilot-instructions.md.
Rules:
- Preserve the existing structure and wording where possible.
- Prefer small, reviewable edits over broad rewrites.
- Remove exact duplicates.
- Merge overlapping guidance only when the meaning is the same or one source clearly supersedes the other.
- If existing instructions conflict with the referenced style guides, update them to match the style guides.
- Summarize guidance into actionable instructions. Do not copy large examples, templates, or explanatory text unless needed.
- Do not make wrapping-only or other arbitrary style edits.
- Do not edit any other files, including
AGENTS.md,GEMINI.md, orCLAUDE.md.
If any remote source cannot be fetched, stop and report the missing source instead of guessing.
After editing, provide a short summary of the changes made.