# Hermes Skills Audit

**Date:** 2026-06-02
**Auditor:** Claude Code
**Scope:** `/home/ubuntu/.hermes/skills/` (global); profile-local skills listed separately (excluded from cleanup recommendations)

---

## Inventory

### Global Skills Directory
| Category | Count | Notable |
|---|---|---|
| `openclaw-imports/` | 11 | Imported from OpenClaw platform |
| `software-development/` | 14 | Development methodology skills |
| `github/` | 7 | GitHub API operations |
| `creative/` | 22 | Content generation, media |
| `productivity/` | 11 | Workspace tools, task mgmt |
| `mlops/` | 11 | ML training, serving, evaluation |
| `devops/` | 9 | Kanban, deployments, infra |
| `autonomous-ai-agents/` | 8 | Agent delegation skills |
| `research/` | 5 | Papers, blogs, market data |
| `media/` | 8 | Spotify, video, images |
| `apple/` | 5 | macOS/iOS device control |
| `smart-home/` | 1 | Hue lights |
| `email/` | 1 | Himalaya |
| `social-media/` | 2 | Xitter, xurl |
| `note-taking/` | 1 | Obsidian |
| `fitness/` | 2 | Health bridge, watch companion |
| `other/` | 8 | maps, domain-research, yuanbao, etc. |
| **Total** | **158** | |

### Profile-Local Skills (Listed, Not Targeted)
- `glm-longhorizon/skills/`: Full skill tree (mirrors global + extras like `gaming/`, `dogfood/`, `hermes-webui-ops/`)
- `tuvieja/skills/`: Full skill tree (mirrors global)
- `ui-designer/skills/`: Full skill tree + extras (`booking-scraper/`, `pixel-6a/`, `lobbytracker-updater/`, `personal-browser-cdp/`, `political-tracker-card/`, `myristica-ops/`, `wa-bot-fix-troubleshooting/`)

**Note:** Profile-local skills are EXCLUDED from cleanup — per task constraints, they may serve profile-specific purposes.

---

## Findings

### REDUNDANCY — Skills to Merge or Deprecate

#### 1. `find-nearby` superseded by `maps`
- **Files:** `leisure/find-nearby/SKILL.md` vs `productivity/maps/SKILL.md`
- **Why:** `maps` skill explicitly declares `supersedes: [find-nearby]`. Both do the same thing (OSM-based nearby place search) but `maps` is 10x more capable (8 commands, 46 POI categories, geocoding, routing, timezone).
- **Action:** **Deprecate** `leisure/find-nearby/` — keep `maps`. The older skill has inferior coverage and no update path.

#### 2. `openclaw-imports/notion` vs `productivity/notion`
- **Files:** Two distinct Notion skills with different implementations:
  - `openclaw-imports/notion/` — bare curl/HTTP, basic pages/databases
  - `productivity/notion/` — v2.0, includes `ntn` CLI, markdown endpoints, Notion Workers, file uploads
- **Why:** Both serve the same purpose but the `productivity/` version is richer and more modern (includes Workers, better property types, markdown API). The `openclaw-imports/` version is the older, simpler implementation.
- **Action:** **Deprecate** `openclaw-imports/notion/` — consolidate on `productivity/notion` (v2.0).

#### 3. `openclaw-imports/gog` overlapping with `productivity/google-workspace`
- **Files:** `openclaw-imports/gog/SKILL.md` vs `productivity/google-workspace/SKILL.md`
- **Why:** `gog` is a read-only Google Workspace CLI (Gmail, Calendar, Drive, Contacts, Sheets, Docs). `google-workspace` skill does all of that AND write operations. The `gog` skill has useful patterns (parallel multi-query Gmail, attachment extraction, Drive thumbnail workaround) but overlaps with the broader skill.
- **Action:** **Merge useful patterns** from `gog` into `google-workspace`, then **deprecate** `openclaw-imports/gog`. The parallel Gmail search and attachment extraction workarounds are worth preserving inline.

#### 4. `openclaw-imports/google-photos` — orphaned
- **Files:** `openclaw-imports/google-photos/SKILL.md`
- **Why:** This skill has a very basic `gphotos.py` script for listing albums, creating albums, uploading photos. It references an old Python venv pattern. There's no evidence of active use in other skills.
- **Action:** **Audit for use** — check if any other skill calls this. If unused, **purge**. If used, consider whether the functionality is worth keeping or if Google Drive (already in `google-workspace`) covers the use case.

#### 5. `mcporter` vs `native-mcp` — related but acceptable
- **Files:** `mcp/mcporter/SKILL.md` vs `mcp/native-mcp/SKILL.md`
- **Why:** These are complementary, not redundant. `mcporter` is an ad-hoc CLI for one-off MCP tool calls. `native-mcp` is config-based persistent MCP integration via `config.yaml`. Both serve different needs.
- **Action:** **Keep both** — mark as complementary in documentation.

#### 6. `openclaw-imports/summarize` — thin wrapper
- **Files:** `openclaw-imports/summarize/SKILL.md`
- **Why:** A wrapper around the `summarize` CLI (wttr.in-style). Very thin — could be absorbed into a general "CLI utilities" skill or kept as-is if actively used.
- **Action:** **Audit for use** — if not called by other skills, consider **purge**.

---

### STALE — Skills Needing Attention

#### 7. Mass staleness from ~Dec 2025
- **Files:** ~60 skills with timestamps around `1778604539` (Dec 2025)
- **Why:** Many skills haven't been updated in ~6 months. Some reference tools that may have changed (e.g., `google-workspace` mentions gws CLI, `spotify` references Hermes toolset versions).
- **Action:** **Mark for review** — these skills should be checked against current tool versions. High-value candidates: `spotify/`, `youtube-content/`, `comfyui/`, `hevy/` (actually updated recently per timestamp).

#### 8. `openclaw-imports/session-logs` — OpenClaw-specific
- **Files:** `openclaw-imports/session-logs/SKILL.md`
- **Why:** References `~/.clawdbot/agents/` paths — this is OpenClaw session logging, not Hermes. Likely unused in the Hermes context.
- **Action:** **Audit for use** — if no Hermes profile uses OpenClaw session logs, **purge**.

#### 9. `openclaw-imports/weather` — standalone, no dependencies
- **Files:** `openclaw-imports/weather/SKILL.md`
- **Why:** Simple wrapper around wttr.in and Open-Meteo. Works fine, but is it actively used? May be duplicated elsewhere.
- **Action:** **Audit for use** — if not called, **purge**.

---

### MISSING STRUCTURE — Skills Without SKILL.md

#### 10. Skills with weak frontmatter
Most skills have proper frontmatter (`name`, `description`, `version`, `author`). A few have minimal or inconsistent frontmatter:
- `leisure/find-nearby/SKILL.md` — no version, no author (but well-structured body)
- `devops/hermes-webui-deploy/SKILL.md` — needs inspection
- `devops/tailscale-funnel-share/SKILL.md` — needs inspection

**Action:** Add consistent frontmatter to these skills.

#### 11. Some skills lack `metadata.hermes.tags`
Without tags, skills are harder to discover and route. Check:
- `openclaw-imports/` skills mostly use `clawdbot` metadata format, not `hermes` format
- `yuanbao/SKILL.md` — has `hermes` tags

**Action:** Standardize `openclaw-imports/` skills to include `metadata.hermes` for consistency.

---

### DOES TOO MUCH — Skills to Split

#### 12. `openclaw-imports/hevy` — too large
- **File:** `openclaw-imports/hevy/SKILL.md` (~700 lines)
- **Why:** One skill does:
  1. Hevy API basics (workouts, routines, exercises)
  2. Workout program planning (Jeff Nippard Min-Max setup)
  3. Wearable companion (Fitbit Sense 2 bridge)
  4. Fitness session kickstart templates
  5. VPT/coach mode operating loop
  6. Week-numbering pitfall documentation
  7. Complex gym-class PDF parsing
- **Action:** **Split into:**
  - `hevy-api/` — raw API queries, CLI reference
  - `fitness-programming/` — program planning, Min-Max context, training calendar
  - `fitbit-hevy-bridge/` — wearable companion (keep if actively used)

#### 13. `productivity/google-workspace` — very large
- **File:** `productivity/google-workspace/SKILL.md` (~400 lines)
- **Why:** Covers Gmail, Calendar, Drive, Contacts, Sheets, Docs — 6 products. References `gws` CLI, Python script, OAuth setup. References `gog` skill.
- **Action:** **Consider split into:**
  - `gmail/` — email operations (Gmail-specific)
  - `google-calendar/` — calendar only
  - `google-drive/` — Drive, Sheets, Docs (or keep as `google-workspace`)
  
  This is optional — the current structure works, it's just dense.

#### 14. `domain-research` — very large, specialized
- **File:** `domain-research/SKILL.md` (~300 lines)
- **Why:** Covers WHOIS/RDAP lookups, DENIC-specific procedures, legal frameworks (German law), formal letter templates, HTML deployment for non-technical users, email archaeology via Gmail, Google Drive evidence, and complex workflows.
- **Action:** **Split into:**
  - `whois-lookup/` — basic WHOIS/RDAP procedures
  - `domain-dispute-legal/` — legal framework, letter templates (DENIC-specific)
  - `email-archaeology/` — Gmail forensics, evidence gathering

---

### OTHER OBSERVATIONS

#### 15. `openclaw-imports/multi-user-identity-verification` — recent, appears active
- **File:** `openclaw-imports/multi-user-identity-verification/SKILL.md`
- **Observation:** Most recently touched skill (timestamp ~1780369041). Seems actively maintained.
- **Action:** Keep as-is.

#### 16. `software-development/` skill cluster — well-organized
- **Files:** 14 skills covering development methodology
- **Observation:** `writing-plans`, `test-driven-development`, `systematic-debugging`, `subagent-driven-development`, `requesting-code-review`, `spike`, `plan` — these form a coherent "development workflow" system. Well-designed. No action needed.

#### 17. `github/` skill cluster — comprehensive
- **Files:** 7 skills (auth, issues, PR workflow, code review, repo management, codebase inspection, OSS maintenance loop)
- **Observation:** Well-organized. The OSS maintenance loop is specialized (grant applications) — may not be used regularly but well-documented.
- **Action:** Keep as-is.

#### 18. `openclaw-imports/model-router` vs `.agents/skills/model-router/`
- **Observation:** There are TWO model-router skills in different locations. The one in `.agents/skills/` is the active skill (referenced in CLAUDE.md). The one in `.hermes/skills/openclaw-imports/` may be the source.
- **Action:** Confirm which is canonical. If `.agents/skills/` is the working one, consider **deprecating** the `.hermes/skills/openclaw-imports/` version or merging.

#### 19. Kanban skill pair — well-designed
- **Files:** `devops/kanban-orchestrator/SKILL.md` + `devops/kanban-worker/SKILL.md`
- **Observation:** Complementary pair. Both explicitly note they auto-inject into system prompts. Well-documented.
- **Action:** Keep as-is.

#### 20. `social-media/xitter` vs `social-media/xurl`
- **Files:** `social-media/xitter/SKILL.md` vs `social-media/xurl/SKILL.md`
- **Observation:** Both do X/Twitter operations. `xitter` uses x-cli; `xurl` uses xurl CLI. May have overlapping functionality.
- **Action:** **Audit for overlap** — if both work, document which is preferred. If one is better, deprecate the other.

---

## Do First (Top 3 Highest-Leverage Cleanups)

### 1. Deprecate `leisure/find-nearby` → use `productivity/maps`
- **Impact:** Eliminates dead-weight skill, prevents confusion about which to use
- **Effort:** Low — one directory to remove, `maps` is already comprehensive
- **Command:** `rm -rf /home/ubuntu/.hermes/skills/leisure/find-nearby/`

### 2. Deprecate `openclaw-imports/notion` → use `productivity/notion`
- **Impact:** Consolidates Notion handling to the richer v2.0 skill
- **Effort:** Low — one directory to remove, v2.0 is a superset
- **Command:** `rm -rf /home/ubuntu/.hermes/skills/openclaw-imports/notion/`

### 3. Audit `openclaw-imports/google-photos`, `summarize`, `weather`, `session-logs`
- **Impact:** Identifying orphaned skills that bloat the directory
- **Effort:** Medium — need to search for references, confirm no active use
- **Search terms:** `gphotos`, `summarize` CLI, `weather` wttr.in, `clawdbot` session paths
- **Action:** If unused, purge each. If used, document the dependency.

---

## Summary Table

| # | Skill(s) | Issue | Proposed Action |
|---|---|---|---|
| 1 | `leisure/find-nearby` | Superseded by `maps` | **Deprecate** |
| 2 | `openclaw-imports/notion` | Redundant with `productivity/notion` v2.0 | **Deprecate** |
| 3 | `openclaw-imports/gog` | Overlaps `google-workspace` (read-only subset) | **Merge patterns + deprecate** |
| 4 | `openclaw-imports/google-photos` | Unused likely | **Audit → purge if orphan** |
| 5 | `openclaw-imports/summarize` | Thin wrapper | **Audit → purge if orphan** |
| 6 | `openclaw-imports/weather` | May be duplicated | **Audit → purge if orphan** |
| 7 | `openclaw-imports/session-logs` | OpenClaw-specific, likely unused | **Audit → purge if orphan** |
| 8 | `openclaw-imports/hevy` | Does too much (~700 lines) | **Split** into hevy-api + fitness-programming + fitbit-bridge |
| 9 | `productivity/google-workspace` | Dense but functional | **Optional split** into gmail/ + google-calendar/ + google-drive/ |
| 10 | `domain-research` | Does too much (~300 lines) | **Split** into whois-lookup/ + domain-dispute-legal/ + email-archaeology/ |
| 11 | Weak frontmatter skills | Inconsistent metadata | **Add frontmatter** to find-nearby, tailscale-funnel-share, hermes-webui-deploy |
| 12 | `openclaw-imports/` metadata | Non-standard format | **Standardize** to `metadata.hermes` |
| 13 | `social-media/xitter` vs `xurl` | Potential overlap | **Audit** overlap, deprecate weaker |
| 14 | `openclaw-imports/model-router` | Duplicate of `.agents/skills/model-router` | **Confirm canonical** → deprecate or merge |

---

*Audit complete. All changes require Chicho review before execution.*