komal-SkyNET/claude-skill-homeassistant

효율적인 배포 워크플로우, 원격 CLI (Command Line Interface) 액세스, 자동화 검증 및 포괄적인 Lovelace 대시보드 개발을 통한 전문가 수준의 Home Assistant 설정 관리.

이 스킬을 사용하여 구축한 태블릿 최적화 대시보드 예시 - 터치 친화적인 컨트롤, 색상별 상태 표시, 반응형 그리드 레이아웃

Claude가 이 스킬을 인식하고 사용할 수 있는지 확인하세요:

skill-check.mp4

Claude가 스킬을 인식하고 Home Assistant 전문 지식을 로드하는 모습

전체 워크플로우가 작동하는 모습을 처음부터 끝까지 확인하세요 (3배속):

live-demo.mp4

배포, 테스트, 로그 분석 및 git 워크플로우를 포함한 전체 자동화 개발 사이클

이 Claude Code 스킬은 Claude를 다음과 같은 도움을 주는 Home Assistant 전문가로 변모시킵니다:

신속한 개발 워크플로우: scp를 통해 변경 사항을 배포하여 즉시 테스트하고, 안정화되면 git에 커밋합니다. 스마트 리로드(Smart Reload) vs 재시작(Restart): 변경 유형에 따라 리로드할지 재시작할지를 자동으로 결정합니다. 설정 검증 (Configuration Validation): 다운타임을 방지하기 위해 변경 사항을 적용하기 전에 항상 검증합니다. 원격 CLI 액세스: SSH 및 hass-cli를 통해 HA (Home Assistant) 인스턴스를 원활하게 관리합니다.

완전한 검증 프로토콜: 수동으로 트리거하고 로그를 확인하여 자동화를 자동으로 테스트합니다. 오류 탐지 (Error Detection): 템플릿 오류, 유형 불일치 및 실행 실패를 식별합니다. 로그 분석 패턴: 어떤 성공 및 오류 지표를 찾아야 하는지 알고 있습니다. 반복적 수정 워크플로우: 디버깅 및 재테스트 사이클을 안내합니다.

태블릿 최적화: 특정 화면 크기(7인치, 11인치, 13인치)에 최적화된 터치 친화적 대시보드를 생성합니다. 카드 유형 전문성: Mushroom 카드, Tile 카드, Panel vs Sections 뷰를 언제 사용할지 알고 있습니다. 템플릿 패턴: 일반적인 사용 사례에 대해 즉시 사용 가능한 Jinja2 템플릿을 제공합니다:

색상 코딩이 포함된 문/창문 개수 계산
시간/상태에 따른 조건부 표시
다중 조건 상태 표시기

일반적인 문제 해결 (Common Pitfall Solutions): 대시보드 등록, auto-entities 실패, 템플릿 타입 오류 문제를 해결합니다.
실제 사례 (Real-World Examples): 실제 운영 중인 태블릿 대시보드의 작동 예시를 포함합니다.

Git + scp 하이브리드: 버전 관리를 위해 git을 사용하고, 빠른 반복 작업을 위해 scp를 사용합니다.
대시보드 재시작 불필요: 브라우저 새로고침만으로 대시보드 변경 사항을 배포합니다.
Context7 통합: 사용 가능한 경우 MCP를 통해 공식 Home Assistant (HA) 문서를 활용합니다.
배포 결정 트리 (Deployment Decision Tree): 변경 유형에 따라 최적의 워크플로를 안내합니다.

Claude Code가 설치 및 구성되어 있어야 함
Home Assistant 인스턴스에 다음 사항이 설정되어 있어야 함:

SSH 액세스 활성화
/config 디렉토리에 연결된 Git 저장소

로컬 도구 (Local tools):

hass-cli 설치 (pipx install homeassistant-cli)
SSH 키 인증 구성 완료
환경 변수 설정 완료: HASS_SERVER, HASS_TOKEN

cd /path/to/your/homeassistant/config
mkdir -p .claude/skills
cd .claude/skills
...

cd /path/to/your/homeassistant/config
mkdir -p .claude/skills/home-assistant-manager
cd .claude/skills/home-assistant-manager
...

Home Assistant 저장소에서 Claude Code를 시작하면 해당 스킬이 나타납니다. Claude는 자동으로 스킬을 로드하고 전문 지식을 적용합니다.

사용자: "현관문이 5분 이상 열려 있을 때 알림을 보내는 자동화(automation)를 만들어줘"
Claude: [스킬 사용]:
...

사용자: "거실에 있는 11인치 태블릿용으로 조명, 온도 조절기, 문 상태가 포함된 대시보드를 만들어줘"
Claude: [스킬 사용]:
...

사용자: "내 자동화에 str과 int를 비교하는 TypeError가 발생해"
Claude: [스킬 사용]:
1. 정확한 에러 메시지를 확인하기 위해 로그를 점검합니다.
...

이 스킬은 세 가지 핵심 영역에 대한 전문 지식을 제공합니다:

환경 변수를 사용한 hass-cli 명령
SSH 기반의 ha CLI 명령
로그 분석 및 에러 탐지
상태 검증 (State verification)

Git 워크플로우 (Git workflow): 최종 테스트 완료된 변경 사항 적용 시 사용
scp 워크플로우 (scp workflow): 빠른 반복 작업 (대시보드, 테스트) 시 사용
Reload vs Restart: 스마트한 의사 결정
검증 프로토콜 (Verification protocols): 항상 결과 확인

뷰 유형 (View types): 패널 (Panel, 전체 화면) vs 섹션 (Sections, 조직화된 구조)
카드 유형 (Card types): Mushroom, Tile, Template, Auto-entities
템플릿 패턴 (Template patterns): 일반적인 사용 사례를 위한 Jinja2 스니펫
디버깅 (Debugging): JSON 검증, 템플릿 테스트, 엔티티 (Entity) 검증

Home Assistant 커뮤니티의 기여를 환영합니다! 이 스킬은 실제 사용 사례를 통해 개발되었으며, 지속적인 개선을 원합니다.

🎯 Home Assistant 특화 전문 지식에 집중하세요:

✅ 좋은 (GOOD) 기여:

일반적인 사용 사례를 위한 새로운 템플릿 패턴
특정 HA 설정의 함정 (Pitfalls)에 대한 해결책
다양한 기기용 대시보드 카드 예시
통합 (Integration) 특화 배포 워크플로우
자동화 (Automation) 검증 패턴
특정 에러에 대한 로그 분석 패턴

❌ 피해야 할 (AVOID) 일반적인 기여:

일반적인 Git 워크플로우 (HA 특화가 아닌 경우)
일반적인 Python/YAML 모범 사례
HA와 관련 없는 개발 워크플로우

"Common Template Patterns" 섹션에 추가하기:

**패턴 이름:**
```jinja2{% set entities = [...] %}
{{ your_template_logic }}

사용 사례 (Use case): 언제 이 패턴을 사용하는지 설명
출력 예시 (Example output): 생성되는 결과물 표시
...

#### 2. 대시보드 카드 예시 (Dashboard Card Examples)
"Real-World Examples"에 추가하기:
```markdown
### 카드 이름
```json
{
"type": "...",
...
}

최적 용도 (Best for): 기기 유형, 사용 사례
특징 (Features): 이 예시가 유용한 이유
...

#### 3. 함정 해결책 (Pitfall Solutions)
"Common Pitfalls"에 추가하기:
```markdown
**문제 X: 간략한 설명**
- **증상 (Symptom):** 사용자가 목격하는 현상
- **원인 (Cause):** 근본 원인 설명
...

워크플로우 변경을 제안하는 경우:

현재 워크플로우의 문제점 설명
적용되는 구체적인 HA 시나리오 제공
변경 전/후 비교 제시
검증 단계 포함

저장소 포크 (Fork the repository)
기능 브랜치 생성 (Create a feature branch): git checkout -b feature/your-contribution-name

SKILL.md 파일에 **변경 사항을 적용 (Make your changes)**하세요.

본인의 HA (Home Assistant) 환경에서 **철저히 테스트 (Test thoroughly)**하세요.
새로운 기능을 추가하는 경우 **README.md를 업데이트 (Update README.md)**하세요.
다음 내용을 포함하여 **풀 리퀘스트 (Pull Request, PR)를 제출 (Submit a Pull Request)**하세요:

추가하는 내용에 대한 명확한 설명
사용 예시 시나리오
실제 HA 설정에서 작동함을 확인한 검증 결과

PR은 다음 항목을 기준으로 검토됩니다:

✅ HA 특화 가치 (HA-specific value): 실제 HA 문제를 해결하는가?
✅ 정확성 (Accuracy): 정보가 정확하고 최신 상태인가?
✅ 명확성 (Clarity): 문서화가 잘 되어 있고 이해하기 쉬운가?
✅ 테스트 완료 (Tested): 실제 HA 환경에서 검증되었는가?

home-assistant-manager/
├── SKILL.md # YAML 프론트매터(frontmatter)가 포함된 주요 스킬 콘텐츠
├── README.md # 이 파일
...

이 스킬은 공식 Claude 스킬 사양을 따릅니다:

SKILL.md는 name과 description이 포함된 YAML 프론트매터 (YAML frontmatter)를 포함합니다.

논리적인 섹션으로 구성된 콘텐츠
예시, 패턴 및 워크플로 (workflows) 포함
실행 가능한 전문 지식에 집중

스킬이 최적으로 작동하려면 환경에 다음 사항이 갖춰져 있는지 확인하세요:

# SSH 접속 테스트
ssh root@homeassistant.local "ha core info"

# hass-cli 설치
pipx install homeassistant-cli
# 환경 변수 설정 (~/.bashrc 또는 ~/.zshrc에 추가)
...

# HA 설정은 git 저장소여야 합니다
cd /config
git init
...

# 공식 HA 문서를 위한 Context7 추가
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header "CONTEXT7_API_KEY: your_api_key"

신속한 자동화 개발 및 테스트
검증을 통한 안전한 설정 변경
원격 HA 인스턴스 관리
Git 기반 버전 관리 워크플로 (version control workflow)
태블릿에 최적화된 제어 패널
벽면 장착형 대시보드 디스플레이
모바일 대응 레이아웃
터치 친화적인 인터페이스 디자인
Jinja2 템플릿 생성 및 디버깅
동적 센서 계산
조건부 자동화 로직
커스텀 카드 설정
로그 분석 및 오류 탐지
템플릿 타입 오류 해결
대시보드 디버깅
통합 (Integration) 설정 문제
공식 Claude Skills 저장소 (Official Claude Skills Repository)
Home Assistant 문서 (Home Assistant Documentation)
Lovelace UI 문서 (Lovelace UI Documentation)
Home Assistant 커뮤니티 (Home Assistant Community)

MIT License - 자세한 내용은 LICENSE 파일을 참조하십시오.

Komal Venkatesh Ganesan

만약 이 스킬이 귀하의 Home Assistant 설정을 관리하는 데 도움이 되었다면, 개발 지원을 고려해 주세요:

이슈 (Issues): GitHub Issues
토론 (Discussions): GitHub Discussions
Home Assistant 커뮤니티 (Home Assistant Community): 기여 시 claude-skill 태그를 달아주세요.

Home Assistant 커뮤니티를 위해 ❤️를 담아 만들었습니다.

komal-SkyNET/claude-skill-homeassistant

요약

핵심 포인트

skill-check.mp4

live-demo.mp4

댓글