break

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.

| Skill | Description | Triggers |

|-------|-------------|----------|

| [break](skills/break/) | Detects fatigue and suggests rest | Typos, frustrated tone, repetitive mistakes, "need a break" |

| [mood](skills/mood/) | 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 |

Option 1: CLI Install (Recommended)

Use [add-skill](https://github.com/vercel-labs/add-skill) to install skills directly:

```bash

# Install all skills

npx add-skill sanool/healthskills

# Install specific skills

npx add-skill sanool/healthskills --skill break

# List available skills

npx add-skill sanool/healthskills --list

```

This automatically installs to your .claude/skills/ directory.

Option 2: Clone and Copy

Clone the entire repo and copy the skills folder:

```bash

git clone https://github.com/sanool/healthskills.git

cp -r healthskills/skills/* .claude/skills/

```

Option 3: Git Submodule

Add as a submodule for easy updates:

```bash

git submodule add https://github.com/sanool/healthskills.git .claude/healthskills

```

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

```

• 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

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

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:

```

skills/

skill-name/

SKILL.md

```

MIT