# SKILLS.md - Main Agent Skills

## Architecture

Source: `~/projects/skills/{shared,personal,work}/`
Sync: `~/projects/skills/sync-skills.sh`
Restart: `systemctl --user restart openclaw-gateway`

This agent has access to **shared** + **personal** skills (15 total).

## Available Skills

### Shared (10)

| Skill | Purpose |
|-------|---------|
| coding-agent | Claude Code, Codex CLI integration |
| deep-research | Structured research pipeline |
| lobster-jobs | Lobster workflow engine |
| skillcraft | Skill design guide |
| task-tracker | Personal task management |
| technews | TechMeme summaries |
| shorten | URL shortener |
| imagemagick-openclaw-skill | Image manipulation |
| MinerU-PDF-Parser-Clawdbot-Skill | PDF parsing (MinerU) |
| PyMuPDF-PDF-Parser-Clawdbot-Skill | PDF parsing (PyMuPDF) |

### Personal (5)

| Skill | Purpose |
|-------|---------|
| babyconnect-openclaw-skill | Baby activity logging |
| equity-research | Stock analysis with quality scores |
| finance-news | Portfolio and ticker news |
| fitbit-analytics | Fitbit health data |
| oura-analytics | Oura Ring sleep/activity data |

---

## Creating New Skills

### Step 1: Decide Category

| Category | Purpose | Who Uses |
|----------|---------|----------|
| **shared/** | General purpose (coding, research, utilities) | All agents |
| **personal/** | Personal/health/finance | Main agent only |
| **work/** | ShapeScale/business | Work agent only |

### Step 2: Create GitHub Repo

```bash
# Naming: kesslerio/<skill-name>-openclaw-skill
gh repo create kesslerio/<skill-name>-openclaw-skill --private --clone
mv <skill-name>-openclaw-skill ~/projects/skills/<category>/<skill-name>
```

### Step 3: For ShapeScale Skills (Monorepo)

ShapeScale-specific skills go in the monorepo instead:

```bash
# Add folder to monorepo
mkdir ~/projects/shapescale-openclaw-skills/<skill-name>

# Create symlink in work category
ln -s ~/projects/shapescale-openclaw-skills/<skill-name> ~/projects/skills/work/<skill-name>
```

### Step 4: Sync & Restart

```bash
~/projects/skills/sync-skills.sh
systemctl --user restart openclaw-gateway
```

### Step 5: Verify

```bash
openclaw skills list | grep <skill-name>
```

---

*See Obsidian: Claude & Clawdbot Skills Best Practices for skill structure guidelines.*
