danielmiessler · rohan-tessl · Mar 20, 2026
diff --git a/Releases/v4.0.3/.claude/skills/Agents/SKILL.md b/Releases/v4.0.3/.claude/skills/Agents/SKILL.md
@@ -1,66 +1,34 @@
 ---
-name: Agents
+name: agents
 description: Compose CUSTOM agents from Base Traits + Voice + Specialization for specialized perspectives. USE WHEN create custom agents, spin up agents, specialized agents, agent personalities, available traits, list traits, agent voices, compose agent, load agent context, agent profile, spawn parallel agents, launch agents. NOT for agent teams/swarms (use Delegation skill → TeamCreate).
 ---
 
-## 🚨 SCOPE BOUNDARY — This Skill vs Agent Teams
+## Scope Boundary
 
-| {PRINCIPAL.NAME} Says | Which System | NOT This Skill? |
-|-------------|-------------|-----------------|
-| "**custom agents**", "spin up agents", "launch agents" | **THIS SKILL** (Agents) → ComposeAgent → `Task(subagent_type="general-purpose")` | |
-| "**create an agent team**", "**agent team**", "**swarm**" | **Delegation skill** → `TeamCreate` tool | **YES — NOT this skill** |
+| User Says | Route To |
+|-----------|----------|
+| "custom agents", "spin up agents", "launch agents" | **THIS SKILL** → ComposeAgent → `Task(subagent_type="general-purpose")` |
+| "agent team", "swarm" | **Delegation skill** → `TeamCreate` (NOT this skill) |
 
-**If {PRINCIPAL.NAME} says "agent team" or "swarm", do NOT use this skill. Use the Delegation skill which routes to `TeamCreate`.**
+- **This skill** = one-shot parallel workers with unique identities, NO shared state
+- **Agent teams** = persistent coordinated teams with shared task lists, messaging
 
-- **This skill** = one-shot parallel workers with unique identities, NO shared state, fire-and-forget
-- **Agent teams** (Delegation → TeamCreate) = persistent coordinated teams with shared task lists, messaging, multi-turn collaboration
+## Notification
 
----
-
-## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
-
-**You MUST send this notification BEFORE doing anything else when this skill is invoked.**
-
-1. **Send voice notification**:
-   ```bash
-   curl -s -X POST http://localhost:8888/notify \
-     -H "Content-Type: application/json" \
-     -d '{"message": "Running the WORKFLOWNAME workflow in the Agents skill to ACTION"}' \
-     > /dev/null 2>&1 &
-   ```
-
-2. **Output text notification**:
-   ```
-   Running the **WorkflowName** workflow in the **Agents** skill to ACTION...
-   ```
-
-**This is not optional. Execute this curl command immediately upon skill invocation.**
+```bash
+curl -s -X POST http://localhost:8888/notify -H "Content-Type: application/json" -d '{"message": "Running the WORKFLOWNAME workflow in the Agents skill to ACTION"}' > /dev/null 2>&1 &
+```
 
 # Agents - Custom Agent Composition System
 
-**Auto-routes when user mentions custom agents, agent creation, or specialized personalities.**
-**Does NOT handle agent teams/swarms — that's Delegation skill → TeamCreate.**
-
-## Configuration: Base + User Merge
-
-The Agents skill uses the standard PAI SYSTEM/USER two-tier pattern:
-
-| Location | Purpose | Updates With PAI? |
-|----------|---------|-------------------|
-| `Data/Traits.yaml` | Base traits, example voices | Yes |
-| `USER/SKILLCUSTOMIZATIONS/Agents/Traits.yaml` | Your voices, prosody, agents | No |
-
-**How it works:** ComposeAgent.ts loads base traits, then merges user customizations over them. Your customizations are never overwritten by PAI updates.
+## Configuration
 
-### User Customization Directory
+| Location | Purpose |
+|----------|---------|
+| `Data/Traits.yaml` | Base traits, example voices (updates with PAI) |
+| `USER/SKILLCUSTOMIZATIONS/Agents/Traits.yaml` | Your voices, prosody, agents (preserved across updates) |
 
-Create your customizations at:
-```
-~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Agents/
-├── Traits.yaml       # Your traits, voices, prosody settings
-├── NamedAgents.md    # Your named agent backstories (optional)
-└── VoiceConfig.json  # Voice server configuration (optional)
-```
+ComposeAgent.ts loads base traits, then merges user customizations over them.
 
 ## Voice Prosody Settings
 
@@ -114,30 +82,14 @@ voice_mappings:
 | Cautious | 0.70 | 0.05 | 0.90 | Careful, deliberate |
 
 
-## Overview
-
-The Agents skill is a complete agent composition and management system:
-- Dynamic agent composition from traits (expertise + personality + approach)
-- Voice mappings with full prosody control
-- Custom agent creation with unique voices
-- Parallel agent orchestration patterns
-
 ## Workflow Routing
 
-**Available Workflows:**
-- **CREATECUSTOMAGENT** - Create specialized custom agents → `Workflows/CreateCustomAgent.md`
-- **LISTTRAITS** - Show available agent traits → `Workflows/ListTraits.md`
-- **SPAWNPARALLEL** - Launch parallel agents → `Workflows/SpawnParallelAgents.md`
-
-## Route Triggers
-
-**CRITICAL: The word "custom" is the KEY trigger for unique agent identities:**
-
-| User Says | What to Use | Why |
-|-----------|-------------|-----|
-| "**custom agents**", "create **custom** agents" | ComposeAgent + `general-purpose` | Unique personalities, voices, colors |
-| "agents", "launch agents", "bunch of agents" | SpawnParallel workflow | Same identity, parallel grunt work |
-| "use [named agent]" | Named agent | Pre-defined personality from USER config |
+| Trigger | Workflow |
+|---------|----------|
+| "custom agents", "create custom agents" | `Workflows/CreateCustomAgent.md` (ComposeAgent + `general-purpose`) |
+| "agents", "launch agents" | `Workflows/SpawnParallelAgents.md` (same identity, parallel work) |
+| "what traits", "list traits" | `Workflows/ListTraits.md` |
+| "use [named agent]" | Named agent from USER config |
 
 **NEVER use static agent types (Architect, Engineer, etc.) for custom agents — always use `general-purpose` with ComposeAgent prompts.**
 
@@ -208,19 +160,6 @@ bun run ~/.claude/skills/Agents/Tools/ComposeAgent.ts --output json
 | **Named Agents** | Persistent identities defined in USER config | Recurring work, relationships |
 | **Dynamic Agents** | Task-specific specialists composed from traits | One-off tasks, parallel work |
 
-### The Agent Spectrum
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│   NAMED AGENTS          HYBRID USE          DYNAMIC AGENTS          │
-│   (Relationship)        (Best of Both)      (Task-Specific)         │
-├──────────────────────────────────────────────────────────────────────┤
-│ Defined in USER     "Security expert       Ephemeral specialist     │
-│ NamedAgents.md      with [named agent]'s   composed from traits     │
-│                      skepticism"                                     │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
 ## Examples
 
 **Example 1: Create custom agents**
@@ -289,7 +228,3 @@ Alex is a strategic thinker who sees patterns others miss...
 | Standard analysis, research | `sonnet` | Balanced |
 | Deep reasoning, architecture | `opus` | Maximum quality |
 
-## Version History
-
-- **v2.0.0** (2026-01): Restructured to base + user merge pattern, added prosody support
-- **v1.0.0** (2025-12): Initial creation
diff --git a/Releases/v4.0.3/.claude/skills/ContentAnalysis/ExtractWisdom/SKILL.md b/Releases/v4.0.3/.claude/skills/ContentAnalysis/ExtractWisdom/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: ExtractWisdom
+name: extract-wisdom
 description: Content-adaptive wisdom extraction — detects what domains exist in content and builds custom sections (not static IDEAS/QUOTES). Produces tailored insight reports from videos, podcasts, articles. USE WHEN extract wisdom, analyze video, analyze podcast, extract insights, what's interesting, extract from YouTube, what did I miss, key takeaways.
 ---
 

diff --git a/Releases/v4.0.3/.claude/skills/ContentAnalysis/SKILL.md b/Releases/v4.0.3/.claude/skills/ContentAnalysis/SKILL.md
@@ -1,14 +1,27 @@
 ---
-name: ContentAnalysis
-description: Content extraction and analysis — wisdom extraction from videos, podcasts, articles, and YouTube. USE WHEN extract wisdom, content analysis, analyze content, insight report, analyze video, analyze podcast, extract insights, key takeaways, what did I miss, extract from YouTube.
+name: content-analysis
+description: "Content extraction and analysis — wisdom extraction from videos, podcasts, articles, and YouTube. USE WHEN extract wisdom, content analysis, analyze content, insight report, analyze video, analyze podcast, extract insights, key takeaways, extract from YouTube."
 ---
 
 # ContentAnalysis
 
-Unified skill for content extraction and analysis workflows.
+Routes content extraction and analysis requests to the appropriate workflow.
 
 ## Workflow Routing
 
 | Request Pattern | Route To |
 |---|---|
 | Extract wisdom, content analysis, insight report, analyze content | `ExtractWisdom/SKILL.md` |
+
+## Examples
+
+```
+User: "extract wisdom from this YouTube video"
+--> Route to ExtractWisdom/SKILL.md
+
+User: "analyze this podcast and give me key takeaways"
+--> Route to ExtractWisdom/SKILL.md
+
+User: "what are the insights from this article?"
+--> Route to ExtractWisdom/SKILL.md
+```
diff --git a/Releases/v4.0.3/.claude/skills/Investigation/OSINT/SKILL.md b/Releases/v4.0.3/.claude/skills/Investigation/OSINT/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: OSINT
+name: osint
 description: Structured OSINT investigations — people lookup, company intel, investment due diligence, entity/threat intel, domain recon, organization research using public sources with ethical authorization framework. USE WHEN OSINT, due diligence, background check, research person, company intel, investigate, company lookup, domain lookup, entity lookup, organization lookup, threat intel, discover OSINT sources.
 ---
 

diff --git a/Releases/v4.0.3/.claude/skills/Investigation/PrivateInvestigator/SKILL.md b/Releases/v4.0.3/.claude/skills/Investigation/PrivateInvestigator/SKILL.md
@@ -1,67 +1,24 @@
 ---
-name: PrivateInvestigator
+name: private-investigator
 description: Ethical people-finding using 15 parallel research agents (45 search threads) across public records, social media, reverse lookups. Public data only, no pretexting. USE WHEN find person, locate, reconnect, people search, skip trace, reverse lookup, social media search, public records search, verify identity.
 ---
 
 ## Customization
 
-**Before executing, check for user customizations at:**
-`~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PrivateInvestigator/`
+Check for user customizations at `~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PrivateInvestigator/` — if present, load and apply overrides before proceeding.
 
-If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.
+## Notification
 
-
-## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
-
-**You MUST send this notification BEFORE doing anything else when this skill is invoked.**
-
-1. **Send voice notification**:
-   ```bash
-   curl -s -X POST http://localhost:8888/notify \
-     -H "Content-Type: application/json" \
-     -d '{"message": "Running the WORKFLOWNAME workflow in the PrivateInvestigator skill to ACTION"}' \
-     > /dev/null 2>&1 &
-   ```
-
-2. **Output text notification**:
-   ```
-   Running the **WorkflowName** workflow in the **PrivateInvestigator** skill to ACTION...
-   ```
-
-**This is not optional. Execute this curl command immediately upon skill invocation.**
+```bash
+curl -s -X POST http://localhost:8888/notify -H "Content-Type: application/json" -d '{"message": "Running the WORKFLOWNAME workflow in the PrivateInvestigator skill to ACTION"}' > /dev/null 2>&1 &
+```
 
 # PrivateInvestigator - Ethical People Finding
 
-## Core Principle
-
-**PUBLIC DATA ONLY** - No hacking, pretexting, or authentication bypass. All techniques are legal and ethical.
-
+**PUBLIC DATA ONLY** — No hacking, pretexting, or authentication bypass.
 
 ## Workflow Routing
 
-**When executing a workflow, output this notification:**
-```
-Running the **WorkflowName** workflow in the **PrivateInvestigator** skill to ACTION...
-```
-
-## When to Activate
-
-### Direct People-Finding
-- "find [person]", "locate [person]", "search for [person]"
-- "reconnect with [person]", "looking for lost contact"
-- "find an old friend", "locate a former coworker"
-
-### Reverse Lookup
-- "reverse phone lookup", "who owns this email"
-- "reverse image search", "find person by username"
-
-### Investigation
-- "background check" (public data only)
-- "what can you find about [person]"
-- "research [person]"
-
-## Available Workflows
-
 | Trigger | Workflow | Action |
 |---------|----------|--------|
 | "find person", "locate" | `FindPerson.md` | Full investigation using parallel research agents |
@@ -219,8 +176,8 @@ User: "Find Jane Doe's social media, she's a marketing professional in Denver"
 → Reports all accounts with MEDIUM/HIGH confidence
 ```
 
----
+## Validation Checkpoints
 
-**Related Documentation:**
-- Complete workflow details in `Workflows/` directory
-- Integration with Research skill for parallel agent orchestration
+1. **Before reporting**: Verify confidence level meets threshold (HIGH = 3+ identifiers, MEDIUM = 2 identifiers)
+2. **Common names**: Require 3+ matching data points before any identification
+3. **Ethics gate**: Stop if purpose shifts to harassment, subject opted out, or illegal methods required
diff --git a/Releases/v4.0.3/.claude/skills/Investigation/SKILL.md b/Releases/v4.0.3/.claude/skills/Investigation/SKILL.md
@@ -1,15 +1,31 @@
 ---
-name: Investigation
-description: OSINT and people-finding — structured investigations, company intel, due diligence, and ethical people search across public records and social media. USE WHEN OSINT, due diligence, company intel, background check, find person, locate, people search, reconnect, public records, reverse lookup, social media search, verify identity, domain lookup, entity lookup, organization lookup, company lookup, threat intel.
+name: investigation
+description: "OSINT and people-finding — structured investigations, company intel, due diligence, and ethical people search across public records and social media. USE WHEN OSINT, due diligence, company intel, background check, find person, locate, people search, reconnect, public records, reverse lookup, social media search, domain lookup, entity lookup, threat intel."
 ---
 
 # Investigation
 
-Unified skill for OSINT and investigation workflows.
+Routes OSINT and investigation requests to the appropriate sub-skill.
 
 ## Workflow Routing
 
 | Request Pattern | Route To |
 |---|---|
 | OSINT, due diligence, company intel, background check, entity intel, threat intel | `OSINT/SKILL.md` |
 | Find person, locate, people search, reconnect, public records, reverse lookup | `PrivateInvestigator/SKILL.md` |
+
+## Examples
+
+```
+User: "do OSINT on Acme Corp"
+--> Route to OSINT/SKILL.md
+
+User: "run a background check on this company"
+--> Route to OSINT/SKILL.md
+
+User: "help me find an old colleague named John Smith"
+--> Route to PrivateInvestigator/SKILL.md
+
+User: "reverse lookup this phone number"
+--> Route to PrivateInvestigator/SKILL.md
+```
diff --git a/Releases/v4.0.3/.claude/skills/Media/Art/SKILL.md b/Releases/v4.0.3/.claude/skills/Media/Art/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: Art
+name: art
 description: Generate illustrations, technical diagrams, mermaid flowcharts, infographics, header images, thumbnails, comics, and PAI pack icons using multiple rendering backends. USE WHEN art, header images, visualizations, mermaid, flowchart, technical diagram, infographic, PAI icon, pack icon, YouTube thumbnails, ad hoc thumbnails, annotated screenshots, aphorisms, comics, comparisons, D3 dashboards, embossed logo wallpaper, essay illustration, frameworks, maps, recipe cards, remove background, stats, taxonomies, timelines, brand wallpaper, visualize, generate image, Midjourney, compose thumbnail, generate prompt.
 ---
 

diff --git a/Releases/v4.0.3/.claude/skills/Media/Remotion/SKILL.md b/Releases/v4.0.3/.claude/skills/Media/Remotion/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: Remotion
+name: remotion
 description: Programmatic video creation with React via Remotion — compositions, animations, motion graphics, rendered to MP4. USE WHEN video, animation, motion graphics, video rendering, React video, intro video, YouTube video, TikTok video, video production, render video, content to animation, animate content, video overlay.
 ---
 

diff --git a/Releases/v4.0.3/.claude/skills/Media/SKILL.md b/Releases/v4.0.3/.claude/skills/Media/SKILL.md
@@ -1,13 +1,11 @@
 ---
-name: Media
+name: media
 description: Visual and video content creation — illustrations, diagrams, mermaid flowcharts, infographics, header images, PAI pack icons, thumbnails, comics, and programmatic video via Remotion. USE WHEN art, header images, visualizations, mermaid, diagrams, flowcharts, infographics, pack icons, video, animation, motion graphics, Remotion, video rendering, YouTube thumbnails, comics, comparisons, frameworks, maps, timelines, taxonomies, stats, aphorisms, recipe cards, annotated screenshots, D3 dashboards, embossed logo wallpaper, remove background, essay illustration, technical diagrams, content to animation, generate image, Midjourney.
 ---
 
 # Media
 
-Unified skill for visual and video content creation.
-
-## Workflow Routing
+Route visual and video content creation to the appropriate sub-skill.
 
 | Request Pattern | Route To |
 |---|---|