# 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. - Skill: `majiayu000/therapy-orchestrator` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add majiayu000/therapy-orchestrator` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/therapy-orchestrator/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/therapy-orchestrator --- # 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) ```markdown 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-optimizer | Direct route | | "Create FAQ section" | faq-schema-generator | Direct route | | "Write service page for [X]" | therapy-content-generator | May need keyword-research first | | "Find positioning angle" | positioning-angles-therapy | Direct route | | "Build email sequence" | email-welcome-sequence-therapy | May need lead-magnet first | | "Research keywords for [X]" | keyword-research | Request Ahrefs/GSC data | | "Why isn't this converting?" | conversion-optimizer | Direct route | | "Analyze [competitor URL]" | seo-competitor-intelligence | Direct route | | "Check this copy's voice" | brand-voice-therapy | Verify Mode | | "This sounds like AI" | brand-voice-therapy | Then therapy-content-generator Humanize | | "Where do I start?" | THIS SKILL | Full 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 | Skill | Input Needed | Output | Time | |-------|--------------|--------|------| | keyword-research | Ahrefs/GSC data, topic | Priority keywords, opportunities | 30 min | | seo-competitor-intelligence | Competitor URLs | Content gaps, E-E-A-T signals | 45 min | | brand-voice-therapy | Draft content | Voice-matched content | 15-30 min | | positioning-angles-therapy | Service, audience | 3-5 angle options | 20 min | | therapy-content-generator | Keyword, angle, outline | 2000+ word page | 60 min | | faq-schema-generator | Topic, existing FAQs | 10-12 FAQs + JSON-LD | 15 min | | direct-response-copy-therapy | Angle, voice, page section | Hero, CTAs, copy | 20 min | | conversion-optimizer | Current CTAs, page goal | Optimized CTAs, A/B options | 15 min | | meta-title-optimizer | Keyword, differentiators | 5 title variations scored | 15 min | | lead-magnet-therapy | Audience, pain points | Lead magnet concept | 30 min | | email-welcome-sequence-therapy | Lead magnet, positioning | 5-7 email sequence | 45 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 Skill | Pass This | OMIT This | |---------------|-----------|-----------| | **positioning-angles-therapy** | Target audience (1 sentence), primary keyword, 3 differentiators | Full competitor analysis, all keyword variations | | **direct-response-copy-therapy** | Selected angle (1-2 sentences), 5 voice markers max, page section to write | Full Voice DNA (545 lines), complete research | | **therapy-content-generator** | Primary keyword + 2-3 secondaries, outline, angle summary | Competitor deep dive, full keyword spreadsheet | | **conversion-optimizer** | Current CTA text, page goal, target audience (brief) | Content drafts, research data | | **meta-title-optimizer** | Primary keyword, 3 differentiators, SERP competitors | Full page content, research | | **brand-voice-therapy** (verify) | Draft content, 7-question checklist | Research data, previous drafts | | **faq-schema-generator** | Topic, existing questions, audience | Full page content | | **email-welcome-sequence-therapy** | Lead magnet concept (brief), positioning angle | Full lead magnet development docs | ### Context Compression Principle | From Skill | Compress To | |------------|-------------| | keyword-research | Top 3 keywords + difficulty + volume (not full spreadsheet) | | seo-competitor-intelligence | 3 content gaps in bullets (not full analysis) | | positioning-angles-therapy | Winning angle in 1-2 sentences (not all 5 options) | | therapy-content-generator | Key insights in 5 bullets (not full 2500-word draft) | | brand-voice-therapy | 5 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: ```markdown ## 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 ```markdown ## 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: ```markdown ## 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 | Goal | Primary Skill | Secondary Skills | Workflow | |------|---------------|------------------|----------| | Create new page | therapy-content-generator | keyword-research, positioning-angles-therapy, faq-schema-generator | Workflow 1 | | Improve existing page | (varies by diagnosis) | brand-voice-therapy (verify) | Workflow 2 | | Build email list | lead-magnet-therapy | email-welcome-sequence-therapy, direct-response-copy-therapy | Workflow 3 | | Research competition | seo-competitor-intelligence | keyword-research | Workflow 4 | | Fix AI-sounding content | brand-voice-therapy | therapy-content-generator Humanize | Workflow 5 | | Improve CTR | meta-title-optimizer | - | Direct | | Improve conversions | conversion-optimizer | direct-response-copy-therapy | Direct | | Find positioning | positioning-angles-therapy | - | Direct | ### By What's Missing | Missing | Run This First | |---------|----------------| | Don't know what keyword to target | keyword-research | | Don't know what makes me different | positioning-angles-therapy | | Don't have content | therapy-content-generator | | Don't have FAQ section | faq-schema-generator | | Don't have lead magnet | lead-magnet-therapy | | Don't have email sequence | email-welcome-sequence-therapy | | Copy doesn't sound like me | brand-voice-therapy | | Page isn't converting | conversion-optimizer | | Title isn't getting clicks | meta-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