原始内容
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 | Detects fatigue and suggests rest | Typos, frustrated tone, repetitive mistakes, "need a break" |
| 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 |
Installation
Option 1: CLI Install (Recommended)
npx skills add sanool/healthskills
Install specific skills only:
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:
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
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:
---
name: skill-name
description: When to use this skill...
---
# Skill Title
Your skill instructions here...
See Claude Code Skills Documentation for complete reference.
License
MIT