# Claude Skills Collection

This repository contains custom Claude Code skills for various use cases.

## Available Skills

### Home Assistant Skill

**Location:** `homeassistant.skill` (packaged) or `skills/homeassistant/` (source)

Comprehensive Home Assistant smart home automation toolkit that helps with:
- Creating and editing automations in YAML
- Controlling and querying devices via the Home Assistant API
- Writing and validating configuration files
- Troubleshooting automation and configuration issues
- Understanding Home Assistant concepts (triggers, conditions, actions)

**Features:**
- Python scripts for API interaction
- YAML validation tools
- Pre-built automation templates
- Comprehensive reference documentation
- Troubleshooting guides

## Installation

### As Personal Skill (recommended)

```bash
# Extract and install to personal skills directory
mkdir -p ~/.claude/skills/homeassistant
unzip homeassistant.skill -d ~/.claude/skills/
mv ~/.claude/skills/homeassistant/homeassistant/* ~/.claude/skills/homeassistant/
rmdir ~/.claude/skills/homeassistant/homeassistant
```

### As Project Skill

```bash
# Extract and install to project skills directory
mkdir -p .claude/skills/homeassistant
unzip homeassistant.skill -d .claude/skills/
mv .claude/skills/homeassistant/homeassistant/* .claude/skills/homeassistant/
rmdir .claude/skills/homeassistant/homeassistant
```

## Skill Structure

Skills in this repository include:
- `SKILL.md` - Main skill documentation with YAML frontmatter
- `scripts/` - Executable Python/Bash scripts
- `references/` - Detailed documentation loaded as needed
- `assets/` - Templates and resources for output

## Usage

Skills are automatically activated by Claude Code when relevant to your request. No manual invocation needed.

## Contributing

This is a personal skill collection. Feel free to fork and adapt for your own use.

## License

See individual skill directories for licensing information.
