therapy-orchestrator

Master coordinator for NextStep Therapy's 12 skills. Diagnoses what the user needs, routes to appropriate skills, manages state across sessions, and handles context handoffs with Context Paradox awareness. Use when starting new projects, when user says 'help me with [X]' without specifics, when switching between tasks, or when determining which skill(s) to apply. Prevents context overload that degrades output quality. Includes 5 pre-built therapy workflows for common scenarios. Triggers on: help me with marketing, where do I start, what should I do first, I need to, complex multi-skill requests, ambiguous content requests.

$ Installer

git clone https://github.com/majiayu000/claude-skill-registry /tmp/claude-skill-registry && cp -r /tmp/claude-skill-registry/skills/productivity/therapy-orchestrator ~/.claude/skills/claude-skill-registry

// tip: Run this command in your terminal to install the skill


name: therapy-orchestrator description: "Master coordinator for NextStep Therapy's 12 skills. Diagnoses what the user needs, routes to appropriate skills, manages state across sessions, and handles context handoffs with Context Paradox awareness. Use when starting new projects, when user says 'help me with [X]' without specifics, when switching between tasks, or when determining which skill(s) to apply. Prevents context overload that degrades output quality. Includes 5 pre-built therapy workflows for common scenarios. Triggers on: help me with marketing, where do I start, what should I do first, I need to, complex multi-skill requests, ambiguous content requests."

Therapy Orchestrator

The traffic controller for NextStep Therapy's 12 skills. Routes users to the right skill(s) in the right order, with the right context.


The Core Job

Diagnose what the user actually needs, then route to appropriate skill(s) with proper context.

Why this matters:

  • Wrong skill order = wasted effort
  • Too much context = degraded output (Context Paradox)
  • No state tracking = duplicate work
  • Ambiguous routing = user confusion

When to Use This Skill

Use orchestrator when:

  • Starting any new content project
  • User request is ambiguous ("help me with marketing")
  • Multiple skills might apply
  • Need to track state across session
  • Switching between tasks mid-project

Skip orchestrator when:

  • Request is specific and obvious
  • Single skill clearly applies
  • Continuing work from identified skill

Diagnostic Intake Questions

Quick Diagnosis (Ask These First)

1. WHAT are you trying to create?
   [ ] New page (service, location, student, professional)
   [ ] Optimize existing page
   [ ] Email sequence / lead magnet
   [ ] Research / analysis only
   [ ] Something else: ________

2. WHAT do you have already?
   [ ] Keyword research / Ahrefs data
   [ ] Competitor analysis
   [ ] Existing content to improve
   [ ] Nothing yet

3. WHERE in the process are you?
   [ ] Just starting (need research first)
   [ ] Know what I want, need to execute
   [ ] Have draft, need to improve
   [ ] Have final, need to verify

4. WHAT'S the priority?
   [ ] Speed (good enough, fast)
   [ ] Quality (thorough, take time)
   [ ] Both (realistic timeline)

Quick Routing Table (For Obvious Requests)

User says...Route to...Notes
"Optimize this meta title"meta-title-optimizerDirect route
"Create FAQ section"faq-schema-generatorDirect route
"Write service page for [X]"therapy-content-generatorMay need keyword-research first
"Find positioning angle"positioning-angles-therapyDirect route
"Build email sequence"email-welcome-sequence-therapyMay need lead-magnet first
"Research keywords for [X]"keyword-researchRequest Ahrefs/GSC data
"Why isn't this converting?"conversion-optimizerDirect route
"Analyze [competitor URL]"seo-competitor-intelligenceDirect route
"Check this copy's voice"brand-voice-therapyVerify Mode
"This sounds like AI"brand-voice-therapyThen therapy-content-generator Humanize
"Where do I start?"THIS SKILLFull diagnosis needed

Complete Skill Registry (12 Skills)

Skill Layers

FOUNDATION LAYER (Research & Voice)
├── keyword-research           → Validates keyword opportunity, finds quick wins
├── seo-competitor-intelligence → Analyzes competitors, finds content gaps
└── brand-voice-therapy         → Applies Jesse's Voice DNA to all content

STRATEGY LAYER (Positioning & Structure)
├── positioning-angles-therapy  → Finds CRPO-compliant positioning angles
├── therapy-content-generator   → Structures and writes page content (2000+ words)
└── faq-schema-generator        → Creates FAQ sections with JSON-LD schema

EXECUTION LAYER (Copy & Conversion)
├── direct-response-copy-therapy → Writes CRPO-compliant persuasive copy
├── conversion-optimizer         → Optimizes CTAs and hero sections
└── meta-title-optimizer         → Creates CTR-optimized title/meta tags

NURTURE LAYER (Email & Lead Gen)
├── lead-magnet-therapy          → Creates CRPO-safe lead magnets (no assessments)
└── email-welcome-sequence-therapy → Creates 5-7 email welcome sequences

COORDINATION LAYER
└── therapy-orchestrator (this skill) → Routes and coordinates all skills

Skill Quick Reference

SkillInput NeededOutputTime
keyword-researchAhrefs/GSC data, topicPriority keywords, opportunities30 min
seo-competitor-intelligenceCompetitor URLsContent gaps, E-E-A-T signals45 min
brand-voice-therapyDraft contentVoice-matched content15-30 min
positioning-angles-therapyService, audience3-5 angle options20 min
therapy-content-generatorKeyword, angle, outline2000+ word page60 min
faq-schema-generatorTopic, existing FAQs10-12 FAQs + JSON-LD15 min
direct-response-copy-therapyAngle, voice, page sectionHero, CTAs, copy20 min
conversion-optimizerCurrent CTAs, page goalOptimized CTAs, A/B options15 min
meta-title-optimizerKeyword, differentiators5 title variations scored15 min
lead-magnet-therapyAudience, pain pointsLead magnet concept30 min
email-welcome-sequence-therapyLead magnet, positioning5-7 email sequence45 min

Dependency Tree

What Needs What

NEW SERVICE PAGE (Full Build)

keyword-research ─────────────────┐
                                  │
seo-competitor-intelligence ──────┼──→ positioning-angles-therapy
                                  │              │
brand-voice-therapy ──────────────┘              ↓
                                        therapy-content-generator
                                                 │
                              ┌──────────────────┼──────────────────┐
                              ↓                  ↓                  ↓
                    faq-schema-generator  direct-response-copy  meta-title-optimizer
                                                 │
                                                 ↓
                                        conversion-optimizer
                                                 │
                                                 ↓
                                        brand-voice-therapy (verify)
EMAIL LIST BUILDING

positioning-angles-therapy ──→ lead-magnet-therapy ──→ email-welcome-sequence-therapy
        ↓                              ↓
brand-voice-therapy            direct-response-copy-therapy
                                    (landing page)
EXISTING PAGE OPTIMIZATION

meta-title-optimizer (if CTR issue)
        ↓
conversion-optimizer (if conversion issue)
        ↓
brand-voice-therapy (if "sounds like AI")
        ↓
faq-schema-generator (if no FAQ section)
        ↓
therapy-content-generator Humanize (if AI detection)

The Context Paradox (CRITICAL)

Why More Context ≠ Better Output

The problem: Loading all previous research into every skill overwhelms the model and degrades output quality. Output becomes:

  • Hedged and committee-sounding
  • Overly comprehensive (loses punch)
  • Trying to please all inputs (pleases none)

The solution: Selective context passing. Each skill gets only what it needs.

Context Passing Rules

To This SkillPass ThisOMIT This
positioning-angles-therapyTarget audience (1 sentence), primary keyword, 3 differentiatorsFull competitor analysis, all keyword variations
direct-response-copy-therapySelected angle (1-2 sentences), 5 voice markers max, page section to writeFull Voice DNA (545 lines), complete research
therapy-content-generatorPrimary keyword + 2-3 secondaries, outline, angle summaryCompetitor deep dive, full keyword spreadsheet
conversion-optimizerCurrent CTA text, page goal, target audience (brief)Content drafts, research data
meta-title-optimizerPrimary keyword, 3 differentiators, SERP competitorsFull page content, research
brand-voice-therapy (verify)Draft content, 7-question checklistResearch data, previous drafts
faq-schema-generatorTopic, existing questions, audienceFull page content
email-welcome-sequence-therapyLead magnet concept (brief), positioning angleFull lead magnet development docs

Context Compression Principle

From SkillCompress To
keyword-researchTop 3 keywords + difficulty + volume (not full spreadsheet)
seo-competitor-intelligence3 content gaps in bullets (not full analysis)
positioning-angles-therapyWinning angle in 1-2 sentences (not all 5 options)
therapy-content-generatorKey insights in 5 bullets (not full 2500-word draft)
brand-voice-therapy5 voice markers (not 545-line Voice DNA)

When to Run Fresh (No Context)

Run a skill with minimal context when:

  • Previous skill output feels off
  • You want a different angle than emerged
  • Output is getting worse, not better through iterations
  • You need bold, punchy copy (not hedged, comprehensive)
  • Copy sounds like a committee wrote it

Fresh start prompt pattern:

"Write [content type] for [topic]. Target: [1 sentence audience]. Angle: [1 sentence]. Be bold. Ignore everything else."


Handoff Protocol Format

Standard Handoff Block

When routing between skills, use this format:

## HANDOFF: [From Skill] → [To Skill]

### Critical Context (ONLY what next skill needs):
- **Target keyword:** [X]
- **Selected angle:** [1-2 sentences]
- **Voice markers:** [5 items max from brand-voice-therapy]
- **CRPO constraints:** [Specific to this content]

### What NOT to pass:
- [List 2-3 things explicitly excluded]

### Explicit instructions:
[1-2 sentences telling receiving skill what to do]

Example Handoff

## HANDOFF: positioning-angles-therapy → direct-response-copy-therapy

### Critical Context:
- **Target keyword:** anxiety therapy Ontario
- **Selected angle:** "WITH you, not ahead of you - virtual therapy that meets you where you are"
- **Voice markers:**
  1. Start with disclaimer
  2. Use "right?" check-ins
  3. Process over outcome
  4. "Should vs. want" distinction
  5. Soft CTA ("no pressure")
- **CRPO constraints:** No outcome promises, no testimonials

### What NOT to pass:
- Other 4 angle options
- Full competitor analysis
- Complete Voice DNA document

### Explicit instructions:
Write hero section (3-4 sentences) and 2 CTA variations using the selected angle and voice markers. Focus on anxiety therapy service page.

State Tracking Template

Session State

Track progress across a session:

## SESSION STATE

### Project: [Name]
**Started:** [Date]
**Goal:** [What we're trying to achieve]

### Completed Steps:
- [ ] Keyword research: [keyword] (KD: [X], Vol: [Y])
- [ ] Competitor analysis: [URLs analyzed]
- [ ] Positioning angle: [Selected angle]
- [ ] Content structure: [Section outline]
- [ ] Full content: [Draft complete]
- [ ] Voice check: [Pass/Fail]
- [ ] CTA optimization: [Completed]
- [ ] Meta title: [Final title]
- [ ] FAQ schema: [Added]

### Current Step:
**Skill:** [Active skill]
**Status:** [In progress / Blocked / Complete]

### Context for Next Skill:
[Relevant output from previous skill - COMPRESSED]

### Blockers:
- [ ] Need Ahrefs data
- [ ] Need GSC data
- [ ] Need competitor URLs
- [ ] Need user decision on angle
- [ ] Other: ________

### Next Steps:
1. [Action]
2. [Action]

Pre-Built Therapy Workflows (5 Scenarios)

Workflow 1: New Service Page (Full Build)

When to use: Creating a new page from scratch for a service/location/audience.

Duration: 2-4 hours

Steps:

1. keyword-research (30 min)
   Input: Topic, Ahrefs/GSC data if available
   Output: Primary keyword, KD, volume, secondaries
   Handoff: keyword + intent + competition level

2. seo-competitor-intelligence (45 min)
   Input: Top 5 competitor URLs
   Output: Content gaps, E-E-A-T signals needed, word count target
   Handoff: 3 key gaps + word count + schema requirements

3. positioning-angles-therapy (20 min)
   Input: Keyword, audience, gaps from step 2
   Output: 3-5 angles, recommended starter
   Handoff: Selected angle + headline direction

4. therapy-content-generator (60 min)
   Input: Keyword, angle, outline, word count target
   Output: 2000+ word content with structure
   Handoff: Full draft

5. faq-schema-generator (15 min)
   Input: Topic, draft content
   Output: 10-12 FAQs with JSON-LD schema
   Handoff: FAQs integrated

6. direct-response-copy-therapy (20 min)
   Input: Draft, angle, voice markers
   Output: Refined hero section, CTAs
   Handoff: Updated draft

7. conversion-optimizer (15 min)
   Input: Current CTAs, page goal
   Output: Optimized CTAs, friction points identified
   Handoff: Final CTA versions

8. meta-title-optimizer (15 min)
   Input: Primary keyword, differentiators
   Output: 5 title variations with scores
   Handoff: Best title selected

9. brand-voice-therapy (15 min)
   Input: Final draft
   Output: Voice verification (Pass/Fail)
   Handoff: COMPLETE (ready for publishing)

Workflow 2: Optimize Existing Page

When to use: Page exists but isn't performing (low CTR, low conversions, sounds like AI).

Duration: 1-2 hours

Steps:

1. Diagnose the problem:
   - Low CTR? → meta-title-optimizer
   - Low conversions? → conversion-optimizer
   - Sounds like AI? → brand-voice-therapy + therapy-content-generator Humanize
   - No FAQ section? → faq-schema-generator
   - Thin content? → therapy-content-generator (expand)

2. Route based on diagnosis (may be 1-3 skills)

3. Always end with: brand-voice-therapy (verify)

Workflow 3: Build Email List

When to use: Want to capture leads via lead magnet and nurture sequence.

Duration: 2-3 hours

Steps:

1. positioning-angles-therapy (20 min)
   Find angle for lead magnet
   Handoff: Angle + target audience pain points

2. lead-magnet-therapy (30 min)
   Create concept (NO diagnostic assessments)
   Handoff: Lead magnet concept + hook

3. direct-response-copy-therapy (30 min)
   Write landing page copy
   Handoff: Landing page draft

4. email-welcome-sequence-therapy (45 min)
   Create 5-7 email nurture sequence
   Handoff: Email sequence draft

5. brand-voice-therapy (30 min)
   Verify all copy matches Jesse's voice
   Handoff: COMPLETE

Workflow 4: Competitive Research Sprint

When to use: Need to understand competitive landscape before creating content.

Duration: 1 hour

Steps:

1. keyword-research (20 min)
   Validate keyword opportunity
   Handoff: Keyword data + opportunity assessment

2. seo-competitor-intelligence (30 min)
   Deep analysis of top 5 competitors
   Handoff: Content gaps, differentiators, E-E-A-T signals

3. positioning-angles-therapy (15 min)
   Find differentiation angles
   Handoff: 3-5 angles for content creation

Output: Strategic brief ready for content creation

Workflow 5: Quick Content Refresh

When to use: Existing content needs freshening (AI detection, outdated, voice drift).

Duration: 30-45 minutes

Steps:

1. therapy-content-generator Humanize section (20 min)
   Focus on AI phrase elimination
   Handoff: Humanized content

2. brand-voice-therapy Verify (10 min)
   Run 7-question test
   Handoff: Pass/Fail + fixes if needed

3. Update "Last Updated" date (2 min)

4. If meta title old: meta-title-optimizer (15 min)

Quick Routing Reference

By User Goal

GoalPrimary SkillSecondary SkillsWorkflow
Create new pagetherapy-content-generatorkeyword-research, positioning-angles-therapy, faq-schema-generatorWorkflow 1
Improve existing page(varies by diagnosis)brand-voice-therapy (verify)Workflow 2
Build email listlead-magnet-therapyemail-welcome-sequence-therapy, direct-response-copy-therapyWorkflow 3
Research competitionseo-competitor-intelligencekeyword-researchWorkflow 4
Fix AI-sounding contentbrand-voice-therapytherapy-content-generator HumanizeWorkflow 5
Improve CTRmeta-title-optimizer-Direct
Improve conversionsconversion-optimizerdirect-response-copy-therapyDirect
Find positioningpositioning-angles-therapy-Direct

By What's Missing

MissingRun This First
Don't know what keyword to targetkeyword-research
Don't know what makes me differentpositioning-angles-therapy
Don't have contenttherapy-content-generator
Don't have FAQ sectionfaq-schema-generator
Don't have lead magnetlead-magnet-therapy
Don't have email sequenceemail-welcome-sequence-therapy
Copy doesn't sound like mebrand-voice-therapy
Page isn't convertingconversion-optimizer
Title isn't getting clicksmeta-title-optimizer

The Test

Before routing to any skill, verify:

  1. Did you ask diagnostic questions? Or is the request obviously specific?
  2. Did you check what already exists? Prevent duplicate work.
  3. Did you identify dependencies? What needs to happen first?
  4. Did you prepare minimal context handoff? Not everything, just essentials.
  5. Did you set expectations for next steps? User knows what's coming.

Anti-Patterns to Avoid

DON'T:

  • Jump to execution without diagnosis
  • Run execution skills without foundation (positioning, voice)
  • Try to do everything at once
  • Feed everything from every skill into the next (Context Paradox)
  • Chain skills when output is getting worse
  • Skip the "boring" strategy work

DO:

  • Start with qualifying questions
  • Build foundation before execution
  • Sequence skills logically
  • Compress context between skills
  • Track what's been created
  • Run fresh when output feels off

Sources

  • Skill inventory: .claude/skills/README.md
  • CLAUDE.md workflows: CLAUDE.md (Skills section)
  • Context Paradox: Adapted from Vibe Marketer orchestrator principles
  • Workflow patterns: AAA Framework content system