skills.rest
home-assistant
home-assistantOFFICIAL
Explore all skills by this author →
Website𝕏@home_assistantGitHub

update-agent-instructions

Updates GitHub Copilot instructions against current Home Assistant documentation style guides.

9.8k|8.5k|Updated Dec 21, 2014
Search Tags:#style guide#update#agent instructions#Documentation#home assistant#gitHub#Copilot instructions
One-click install
npx skills add https://github.com/home-assistant/home-assistant.io --skill update-agent-instructions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-agent-instructions
Source: https://github.com/home-assistant/home-assistant.io/tree/main/.claude/skills/update-agent-instructions
Command: npx skills add https://github.com/home-assistant/home-assistant.io --skill update-agent-instructions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping AI agent instructions in sync with evolving documentation style guides is tedious and error-prone. This Skill reviews .github/copilot-instructions.md against the official Home Assistant style-guide sources and applies small, reviewable edits so the instructions stay accurate.

Core Features & Use Cases

  • Style Guide Synchronization: Compares the existing copilot instructions against the integration docs template, general style guide, YAML style guide, documentation standards, and brand personality sources.
  • Conservative Editing: Preserves existing structure and wording, removes exact duplicates, and merges overlapping guidance only when meanings match.
  • Conflict Resolution: Updates instructions that conflict with the referenced style guides and summarizes guidance into actionable rules.
  • Use Case: After Home Assistant publishes an updated YAML style guide, run this Skill to bring the repository's agent instructions in line without rewriting the whole file.

Quick Start

Ask the agent to update the Home Assistant website agent instructions using the update-agent-instructions skill.

Frequently Asked Questions about update-agent-instructions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update GitHub Copilot instructions for the Home Assistant website?▼

Invoke this Skill, which reviews .github/copilot-instructions.md against the official Home Assistant style-guide sources and applies small, reviewable edits. It preserves existing structure and only changes content that conflicts with the referenced guides.

What style guides does the Home Assistant documentation use?▼

The Skill checks the integration docs template, integration docs examples, documentation standards, general style guide, YAML style guide, and the frontend brand personality page. These sources define the authoritative writing and formatting rules.

Which files does this Skill edit in the home-assistant.io repository?▼

It edits only .github/copilot-instructions.md. It explicitly does not modify AGENTS.md, GEMINI.md, CLAUDE.md, or any other repository files.

What happens if a style guide source cannot be fetched?▼

The Skill stops and reports the missing source instead of guessing. This prevents instructions from being updated based on incomplete or assumed style-guide content.

Does this Skill rewrite the entire copilot instructions file?▼

No. It prefers small, reviewable edits, preserves existing structure and wording where possible, removes exact duplicates, and avoids wrapping-only or arbitrary style changes.

Related Skills

Explore More Software Engineering Skills→
ayarseayarse
19

syncing-docs-with-code

Detect and correct documentation drift using Git history and source inspection.

Community
Advanced
OmniNode-aiOmniNode-ai
3

sharing-skills

Guide users through contributing skills via GitHub CLI pull requests.

Official
Intermediate
Imad-OuteImad-Oute
2

mh-editorial-review-structure

Review written document structure and suggest clarity, brevity, and value improvements.

Community
Advanced
agentscope-aiagentscope-ai
34.3k

make_plan

Generate ordered step-by-step execution plans with dependencies and verification points.

Official
Intermediate