# Skills Registry
*Last updated: 2026-03-05 | Review monthly or when adding new skills*

## How This Works
- On session start, Kitt reads this file to know what skills are available
- Before any task, check if a skill applies → READ its SKILL.md → follow it
- Skills are markdown instruction files that give agents specialized knowledge
- **Usage column** tracks actual invocations. Skills with zero usage are candidates for removal.

## Usage Legend
| Symbol | Meaning |
|--------|---------|
| 🟢 ACTIVE | Used in real work regularly |
| 🟡 MISSED | Work happened but skill was NOT loaded — we did the work manually |
| 🔴 NO DEMAND | No matching work happened at all |
| 🆕 NEW | Recently installed, no usage data yet |
| ⚠️ BLOATED | SKILL.md > 300 lines, needs progressive disclosure refactor |

> **⚠️ CRITICAL FINDING:** Most "unused" skills aren't unused because we don't need them — they're unused because agents aren't loading them when doing matching work. We did 22 days of slide work without reading `slide-layout`. We did 11 days of copy without reading `copywriting`. This is an execution gap, not a relevance gap.

---

## 🎯 Strategy & Marketing

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `copywriting/` | 252 | 🟡 MISSED (11 days of copy work done without it) | Ogilvy | Headlines, CTAs, page structures |
| `copy-editing/` | 447 ⚠️ | 🟡 MISSED (copy passes done ad-hoc) | Ogilvy | Multi-pass editing. **Needs refactor** |
| `marketing-psychology/` | 455 ⚠️ | 🟡 MISSED (positioning work across 4 projects without it) | Kitt / Ogilvy | 70+ mental models. **Needs refactor** |
| `product-marketing-context/` | 241 | 🟡 MISSED (never filled per-client but should be) | Kitt | Foundation context doc for all marketing skills |
| `marketing-analytics-tracking/` | 309 ⚠️ | 🔴 NO DEMAND | Thibault | GA4, GTM, UTM setup and audit |
| `pricing-page-design/` | 212 | 🔴 NO DEMAND | Thibault + Ogilvy | SaaS pricing page structure |
| `pricing-strategy/` | 231 | 🔴 NO DEMAND | Kitt | Pricing strategy frameworks |
| `landing-page-design-mengto/` | 208 | 🟡 MISSED (6 days of landing page work without it) | Thibault + Ogilvy | Landing page conversion framework |
| `launch-strategy/` | 353 ⚠️ | 🔴 NO DEMAND (no launches yet) | Kitt | Product launches, PH strategy |
| `content-strategy/` | 359 ⚠️ | 🔴 NO DEMAND | Julia / Ogilvy | Blog/content planning |
| `cold-email/` | 158 | 🔴 NO DEMAND | Ogilvy | B2B cold email sequences |
| `email-sequence/` | 309 ⚠️ | 🔴 NO DEMAND | Ogilvy | Drip campaigns, nurture sequences |
| `social-content/` | 278 | 🟡 MISSED (X posting without framework) | Julia | Social media content strategy |
| `competitor-alternatives/` | 256 | 🟡 MISSED (10 days competitor research without it) | Thibault / Ogilvy | "X vs Y" alternative pages |
| `ai-seo/` | 398 ⚠️ | 🔴 NO DEMAND | Thibault / Julia | AI search optimization |
| `seo-audit/` | 419 ⚠️ | 🔴 NO DEMAND | Thibault | SEO audit checklists |
| `schema-markup/` | 179 | 🔴 NO DEMAND | Thibault | Schema.org markup |
| `site-architecture/` | 357 ⚠️ | 🔴 NO DEMAND | Thibault | Site architecture planning |
| `page-cro/` | 182 | 🔴 NO DEMAND | Thibault | Conversion rate optimization |

> **⚠️ EXECUTION GAP:** 7 skills have matching work that happened WITHOUT loading the skill. This means agents are doing the work ad-hoc instead of using the frameworks we installed. Fix = enforce skill reads in agent briefs + LEARNINGS.md rule.

---

## 🎨 Design & UI

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `ce-ui-quality/` | 240 | 🟡 MISSED (supposed to gate all CE pages — no evidence of reads) | Anton | CE brand quality gate |
| `frontend-design/` | 127 | 🟡 MISSED (12+ pages built without it) | Thibault | Distinctive frontend interfaces |
| `slide-layout/` | 173 | 🟡 MISSED (22 days deck work without it!) | Jessica | Professional slide layout |
| `ui-design-system/` | 470 ⚠️ | 🔴 NO DEMAND (no React/component work) | Jessica | React/Tailwind/Radix design systems |
| `web-design-guidelines/` | 39 | 🟡 MISSED (pages shipped without review) | Thibault / Anton | UI code review checklist |
| `web-design-reviewer/` | 374 ⚠️ | 🟡 MISSED (pages shipped without visual QA) | Anton / Thibault | Visual inspection + source-level fix |
| `responsive-design/` | 434 ⚠️ | 🟡 MISSED (12+ pages deployed, none checked) | Thibault | Mobile-first responsive layouts |
| `visual-competitive-analysis/` | 105 | 🆕 NEW | Julia / Kitt | Competitor brand DNA pages: color, type, layout, positioning, threat assessment |

---

## ✨ Animation & Motion

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `animation-systems/` | 187 | 🟡 MISSED (animations built ad-hoc) | Thibault | Product-grade motion |
| `gsap-animation-mengto/` | 82 | 🔴 NO DEMAND | Thibault | GSAP timelines, ScrollTrigger |
| `frontend-slides/` | 219 | 🆕 NEW | Thibault / Jessica | HTML presentations. Progressive disclosure model (219-line core + 5 on-demand files). 7.8k⭐ |

---

## 🔍 Research & Intelligence

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `last30days/` | 621 ⚠️ | 🟢 ACTIVE | Julia / Kitt | Multi-platform research. Modular but core bloated |
| `trend-scouting/` | 147 | 🟢 ACTIVE (13 days) | Julia | Daily design/culture trend scanning |
| `visual-research/` | 187 | 🟡 MISSED | Julia | Visual research methodology |
| `personal-radar/` | 157 | 🟢 ACTIVE | Kitt | Morning radar: service health, email, calendar. Cron: 9am Lisbon daily |
| `ai-news-digest/` | 198 | 🆕 NEW | Julia | AI/tech news aggregation and daily digest compilation |

---

## 📬 Google Workspace (gws CLI) — 🆕 NEW

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `gws-shared/` | 66 | 🆕 | Kitt / All | Shared auth, flags, syntax |
| `gws-calendar/` | 108 | 🆕 | Kitt | Calendar events, ACLs, free/busy |
| `gws-calendar-agenda/` | 52 | 🆕 | Kitt | Quick agenda view |
| `gws-calendar-insert/` | 55 | 🆕 | Kitt | Create calendar events |
| `gws-gmail/` | 56 | 🆕 | Kitt | Gmail read, labels, threads |
| `gws-gmail-send/` | 51 | 🆕 | Kitt / Ogilvy | Send emails (requires confirmation) |
| `gws-drive/` | 141 | 🆕 | Kitt / Thibault | Drive files, folders, permissions |
| `gws-drive-upload/` | 52 | 🆕 | Thibault | Upload files to Drive |
| `gws-sheets/` | 53 | 🆕 | Kitt / Thibault | Full Sheets API ✅ enabled |
| `gws-sheets-read/` | 47 | 🆕 | All | Read spreadsheet values |
| `gws-sheets-append/` | 51 | 🆕 | Kitt / Thibault | Append rows to spreadsheets |
| `gws-docs/` | 48 | 🆕 | Ogilvy / Kitt | Google Docs read/write ✅ enabled |
| `gws-slides/` | 43 | 🆕 | Jessica / Thibault | Google Slides presentations |
| `gws-tasks/` | 56 | 🆕 | Kitt | Google Tasks (needs OAuth scope) |
| `gws-workflow/` | 44 | 🆕 | Kitt | Workflows: standup, meeting-prep, weekly-digest |

> **Auth:** `gws-auth` wrapper (auto-refreshes OAuth). Account: kitt@curiousendeavor.com.
> **Replaces:** `gcal.py`, manual Google API scripts.

---

## 🔬 Skill Optimization

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `autoresearch/` | ~200 | 🆕 NEW | Kitt | Auto-optimize any skill using Karpathy's autoresearch loop. Binary evals + mutation loop → improved SKILL.md. Source: Ole Lehmann / Karpathy. |

---

## 🏗️ CE Internal

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `creative-pipeline-management/` | 157 | 🟡 MISSED (pipeline exists but skill not read) | Gerri | Kitchen rules, creative pipeline |
| `ce-deck-design/` | 180 | 🆕 NEW | Jessica / Kitt | CE editorial deck design system. GATE: asks "Is this a CE deck?" before all deck work. |
| `deck-illustrations/` | 116 | 🟢 ACTIVE | Tatiana | Styled illustrations for pitch decks |
| `meeting-processing/` | 142 | 🟢 ACTIVE | Kitt | Meeting transcription and processing |
| `notion-meetings/` | 105 | 🔴 NO DEMAND | Kitt | Notion meeting integration |
| `visual-capture/` | 37 | 🔴 NO DEMAND | Tatiana | Visual intelligence capture |

---

## 📚 PM Skills (modular — good pattern)

| Skill | Lines | Usage | Owner | Description |
|-------|-------|-------|-------|-------------|
| `pm-skills/` (INDEX) | N/A | 🟡 OCCASIONAL | Kitt | 66 sub-skills via INDEX.md → progressive disclosure. Good pattern. |

---

## 🔧 Tools (Infrastructure)

| Tool | Location | Usage | Description |
|------|----------|-------|-------------|
| `pinchtab` | `/usr/local/bin/pinchtab` | 🔴 NO DEMAND | Browser control — text extraction at 800 tokens |
| `scrapling` | system pip | 🔴 NO DEMAND | Web scraping framework — Cloudflare bypass |
| `yt-dlp` | system pip | 🟡 used by last30days | YouTube search/transcripts |

---

## 📊 Usage Summary

| Status | Count | % | Meaning |
|--------|-------|---|---------|
| 🟢 ACTIVE | 4 | 7% | Actually loaded and used |
| 🟡 MISSED | 15 | 25% | Work happened but skill wasn't loaded — execution gap |
| 🔴 NO DEMAND | 14 | 23% | No matching work happened |
| 🆕 NEW | 16 | 26% | Recently installed |

**Key finding: 25% of skills have matching work that was done WITHOUT the skill. This is the real problem — not irrelevant skills, but agents not loading relevant ones.**

### Priority Actions

1. **ENFORCE skill loading** — Add LEARNINGS.md rule: "Before ANY creative/web/copy/deck task, check REGISTRY.md for matching skills and READ them." This fixes the execution gap.
2. **Refactor bloated skills** — 8 skills over 300 lines need progressive disclosure: `marketing-psychology`, `copy-editing`, `responsive-design`, `seo-audit`, `ai-seo`, `content-strategy`, `launch-strategy`, `email-sequence`
3. **Archive true NO DEMAND** — Only after confirming no upcoming project needs them: `schema-markup`, `site-architecture`, `page-cro`, `pricing-page-design`, `pricing-strategy`, `cold-email`
4. **Fill product-marketing-context** — Per-client foundation doc that makes all marketing skills 10x more effective. Never been filled out.
5. **Frontend-slides** — Test on PHAT CEO deck. Maps to highest-activity area (22 days).

---

## Routing Rules
When a task matches a skill, the **Owner** column determines who executes:
- **Ogilvy** → All copy tasks
- **Thibault** → All code/web/tracking tasks
- **Jessica** → Design systems, layout, brand
- **Tatiana** → Visual execution, illustrations
- **Anton** → Quality review, design audit
- **Julia** → Research, trends, publishing
- **Gerri** → Pipeline coordination
- **Kitt** → Strategy, context, orchestration

## How to Add New Skills
1. Find skill on [ClawHub](https://clawhub.com), [Aura](https://aura.build/skills), [skills.sh](https://skills.sh), or GitHub
2. Clone source repo → copy skill folder to `~/.openclaw/workspace/skills/`
3. Add row to the appropriate table above with **Usage: 🆕 NEW**
4. Assign an owner agent
5. Commit: `git add skills/ && git commit -m "Add [skill-name] skill"`
6. **Review usage after 2 weeks** — if 🔴, consider archiving

## Quality Assurance
- **Anton reviews** every skill output before it goes to Assaf
- Skills provide frameworks, not auto-pilot — agents must apply judgment
- `product-marketing-context/` must be filled out per-client before marketing skills are useful