# Health Skills for Claude Code

A collection of AI agent skills focused on developer health and well-being. Built for developers who spend long hours coding and want Claude Code to help them stay healthy, recognize fatigue, and prevent burnout.

## What are Skills?

Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, Claude Code can recognize when you might need a health intervention and apply the right approach.

## Available Skills

| Skill | Description | Triggers |
|-------|-------------|----------|
| [break](skills/break/SKILL.md) | Detects fatigue and suggests rest | Typos, frustrated tone, repetitive mistakes, "need a break" |
| [mood](skills/mood/SKILL.md) | Emotional support with music | Frustration, self-doubt, anxiety, "I quit", feeling stressed |
| eyes | Eye strain assessment (20-20-20 rule) | Coming soon |
| stretch | Quick desk-friendly stretches | Coming soon |
| breathe | Guided breathing for stress relief | Coming soon |
| posture | Posture check reminder | Coming soon |

## Installation

### Option 1: CLI Install (Recommended)

```bash
npx skills add sanool/healthskills
```

Install specific skills only:

```bash
npx skills add sanool/healthskills --skill break
npx skills add sanool/healthskills --skill mood
```

### Option 2: Manual Install

Clone and copy to your skills directory:

```bash
git clone https://github.com/sanool/healthskills.git
cp -r healthskills/skills/* ~/.claude/skills/
```

### Skill Locations

| Location | Path | Applies to |
|----------|------|------------|
| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | All your projects |
| Project | `.claude/skills/<skill-name>/SKILL.md` | This project only |

## Usage

Once installed, Claude Code will automatically detect signs of fatigue and check in with you:

```
User: "ugh this stuipd funtcion wont owrk i've treid everything"

Claude: "Hey, I can help debug this. Also noticed a few typos there -
been at this for a while? Sometimes a 5-min break helps the solution click.
But let's look at the function first - what's it supposed to do?"
```

You can also invoke skills directly:

```
/break
/mood
/stretch
```

## Design Philosophy

- **Non-intrusive** - Your work comes first, health check is secondary
- **Respectful** - If you say you're fine, we believe you
- **Casual** - Like a colleague checking in, not a doctor lecturing
- **Brief** - Quick suggestions, not lengthy interventions

## Documentation

- [English](README.md)
- [简体中文](docs/README.zh-CN.md)
- [日本語](docs/README.ja.md)

## Contributing

Found a way to improve a skill? Have a new health skill to suggest? PRs and issues welcome!

### Skill File Structure

Each skill is a directory containing a `SKILL.md` file with YAML frontmatter:

```
~/.claude/skills/
  skill-name/
    SKILL.md           # Main instructions (required)
    template.md        # Optional template
    examples/          # Optional examples
    scripts/           # Optional scripts
```

Example `SKILL.md` structure:

```yaml
---
name: skill-name
description: When to use this skill...
---

# Skill Title

Your skill instructions here...
```

See [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills) for complete reference.

## License

MIT