create-merlin-brain 2.3.3 → 2.4.0

package/files/loop/lib/agents.sh

@@ -0,0 +1,603 @@
+#!/usr/bin/env bash
+#
+# Merlin Loop - Agent Profiles & Routing
+# Task → Agent mapping based on keywords
+#
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Agent Definitions
+# Each agent has: triggers, display_name, required_skills, context_injection
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Agent: hardening-guard (Security Specialist)
+AGENT_hardening_guard_TRIGGERS="auth login password token security 2fa oauth jwt session encrypt decrypt hash"
+AGENT_hardening_guard_DISPLAY="Security Specialist (hardening-guard)"
+AGENT_hardening_guard_SKILLS="security-patterns"
+AGENT_hardening_guard_CONTEXT="Security Guidelines:
+- Always sanitize user input
+- Use parameterized queries for database operations
+- Implement rate limiting on auth endpoints
+- Never store passwords in plain text (use bcrypt/argon2)
+- Validate JWT tokens on every request
+- Use HTTPS everywhere
+- Implement CSRF protection for forms
+- Check OWASP Top 10 considerations"
+
+# Agent: merlin-frontend (Frontend Specialist)
+AGENT_merlin_frontend_TRIGGERS="ui component design css layout responsive frontend react vue angular svelte tailwind"
+AGENT_merlin_frontend_DISPLAY="Frontend Specialist (merlin-frontend)"
+AGENT_merlin_frontend_SKILLS="canvas-design accessibility-patterns"
+AGENT_merlin_frontend_CONTEXT="Frontend Guidelines:
+- Follow component composition patterns
+- Ensure keyboard navigation works
+- Make components screen reader compatible
+- Design mobile-first, then scale up
+- Use semantic HTML elements
+- Keep components under 200 lines
+- Extract reusable hooks and utilities"
+
+# Agent: merlin-api-designer (API Specialist)
+AGENT_merlin_api_designer_TRIGGERS="api endpoint route rest graphql webhook handler controller"
+AGENT_merlin_api_designer_DISPLAY="API Designer (merlin-api-designer)"
+AGENT_merlin_api_designer_SKILLS="api-patterns"
+AGENT_merlin_api_designer_CONTEXT="API Design Guidelines:
+- Use RESTful conventions (GET/POST/PUT/DELETE)
+- Return consistent response formats
+- Include proper HTTP status codes
+- Add request validation middleware
+- Document endpoints with OpenAPI/Swagger
+- Implement pagination for list endpoints
+- Use versioning (/api/v1/) for stability"
+
+# Agent: system-architect (Architecture Specialist)
+AGENT_system_architect_TRIGGERS="database schema model migration architecture structure service microservice"
+AGENT_system_architect_DISPLAY="System Architect"
+AGENT_system_architect_SKILLS=""
+AGENT_system_architect_CONTEXT="Architecture Guidelines:
+- Prefer fewer services over many microservices
+- Keep data models normalized but practical
+- Use foreign keys for referential integrity
+- Add indexes on frequently queried columns
+- Consider future scalability but don't over-engineer
+- Document architectural decisions"
+
+# Agent: tests-qa (Testing Specialist)
+AGENT_tests_qa_TRIGGERS="test spec coverage unit integration e2e jest mocha pytest"
+AGENT_tests_qa_DISPLAY="Testing Specialist (tests-qa)"
+AGENT_tests_qa_SKILLS="testing-patterns"
+AGENT_tests_qa_CONTEXT="Testing Guidelines:
+- Write tests for happy path first
+- Add edge case tests for critical paths
+- Mock external services
+- Keep tests isolated and repeatable
+- Use descriptive test names
+- Aim for meaningful coverage, not 100%
+- Test behavior, not implementation"
+
+# Agent: dry-refactor (Refactoring Specialist)
+AGENT_dry_refactor_TRIGGERS="refactor cleanup dry organize structure split extract"
+AGENT_dry_refactor_DISPLAY="Refactoring Specialist (dry-refactor)"
+AGENT_dry_refactor_SKILLS="code-organization"
+AGENT_dry_refactor_CONTEXT="Refactoring Guidelines:
+- Keep files under 400 lines
+- Extract shared logic into utilities
+- Use consistent naming conventions
+- Group related functions together
+- Remove dead code
+- Prefer composition over inheritance
+- Make small, atomic changes"
+
+# Agent: ops-railway (DevOps Specialist)
+AGENT_ops_railway_TRIGGERS="deploy infra railway docker env ci cd pipeline build"
+AGENT_ops_railway_DISPLAY="DevOps Specialist (ops-railway)"
+AGENT_ops_railway_SKILLS=""
+AGENT_ops_railway_CONTEXT="DevOps Guidelines:
+- Never commit secrets to git
+- Use environment variables for config
+- Keep Dockerfiles minimal and secure
+- Add health check endpoints
+- Log errors with context
+- Set up proper monitoring
+- Document deployment steps"
+
+# Agent: docs-keeper (Documentation Specialist)
+AGENT_docs_keeper_TRIGGERS="docs readme documentation comment jsdoc typedoc markdown"
+AGENT_docs_keeper_DISPLAY="Documentation Specialist (docs-keeper)"
+AGENT_docs_keeper_SKILLS=""
+AGENT_docs_keeper_CONTEXT="Documentation Guidelines:
+- Keep docs close to code
+- Document the 'why', not just 'what'
+- Include examples for complex APIs
+- Update docs when code changes
+- Use markdown for readability
+- Add inline comments for tricky logic"
+
+# Agent: merlin-debugger (Debugging Specialist)
+AGENT_merlin_debugger_TRIGGERS="debug fix error bug issue crash trace log"
+AGENT_merlin_debugger_DISPLAY="Debugging Specialist (merlin-debugger)"
+AGENT_merlin_debugger_SKILLS=""
+AGENT_merlin_debugger_CONTEXT="Debugging Guidelines:
+- Reproduce the issue first
+- Check logs and error messages
+- Use binary search to isolate the problem
+- Add debug logging if needed
+- Verify the fix doesn't break other tests
+- Document the root cause"
+
+# Agent: apple-swift-expert (Apple Platform Specialist)
+AGENT_apple_swift_expert_TRIGGERS="swift swiftui appkit ios macos iphone ipad xcode cocoa uikit swift6 swiftdata coredata"
+AGENT_apple_swift_expert_DISPLAY="Apple Swift Expert (apple-swift-expert)"
+AGENT_apple_swift_expert_SKILLS=""
+AGENT_apple_swift_expert_CONTEXT="Apple Development Guidelines:
+- Use Swift 6 with async/await and actors
+- Default to SwiftUI over UIKit/AppKit
+- Use @Observable not ObservableObject
+- Follow Apple Human Interface Guidelines
+- Use SF Symbols for icons
+- Target newest platform APIs available"
+
+# Agent: android-expert (Android Specialist)
+AGENT_android_expert_TRIGGERS="android kotlin compose jetpack material gradle room hilt viewmodel coroutine play-store apk aab"
+AGENT_android_expert_DISPLAY="Android Expert (android-expert)"
+AGENT_android_expert_SKILLS=""
+AGENT_android_expert_CONTEXT="Android Development Guidelines:
+- Use Kotlin with coroutines, never Java for new code
+- Use Jetpack Compose for UI, not XML layouts
+- Follow MVVM + Clean Architecture
+- Use Hilt for dependency injection
+- Use Material Design 3 with dynamic color
+- Test with LeakCanary and Compose testing"
+
+# Agent: ui-designer (UI/UX Design Specialist)
+AGENT_ui_designer_TRIGGERS="design-system accessibility wcag color-palette typography spacing visual-hierarchy wireframe mockup ux hig"
+AGENT_ui_designer_DISPLAY="UI Designer (ui-designer)"
+AGENT_ui_designer_SKILLS=""
+AGENT_ui_designer_CONTEXT="UI Design Guidelines:
+- Design with accessibility first (WCAG 2.1 AA)
+- Use semantic color tokens, not raw values
+- 4.5:1 contrast ratio for text minimum
+- Touch targets minimum 44x44px
+- Document all component states
+- Design for dark mode simultaneously"
+
+# Agent: ui-builder (UI Component Builder)
+AGENT_ui_builder_TRIGGERS="shadcn radix component-library tailwind form table card modal dialog sheet"
+AGENT_ui_builder_DISPLAY="UI Builder (ui-builder)"
+AGENT_ui_builder_SKILLS=""
+AGENT_ui_builder_CONTEXT="UI Building Guidelines:
+- Use existing design system components first
+- Tailwind CSS with consistent ordering
+- All components must handle loading/empty/error states
+- Mobile-first responsive design
+- Accessible by default (keyboard nav, aria labels)
+- Copy-paste ready production code"
+
+# Agent: animation-expert (Animation Specialist)
+AGENT_animation_expert_TRIGGERS="animation motion framer gsap transition scroll-animation parallax spring keyframe animate"
+AGENT_animation_expert_DISPLAY="Animation Expert (animation-expert)"
+AGENT_animation_expert_SKILLS=""
+AGENT_animation_expert_CONTEXT="Animation Guidelines:
+- Import from motion/react not framer-motion
+- Only animate transform and opacity (GPU accelerated)
+- Never animate width, height, top, left
+- Always respect prefers-reduced-motion
+- Use spring physics for natural feel
+- Clean up GSAP contexts on unmount
+- Keep animations purposeful, not decorative"
+
+# Agent: marketing-automation (Marketing Automation Specialist)
+AGENT_marketing_automation_TRIGGERS="email campaign drip newsletter marketing automation funnel conversion ab-test analytics tracking utm landing-page growth"
+AGENT_marketing_automation_DISPLAY="Marketing Automation (marketing-automation)"
+AGENT_marketing_automation_SKILLS=""
+AGENT_marketing_automation_CONTEXT="Marketing Automation Guidelines:
+- Always include unsubscribe in marketing emails
+- Use type-safe event tracking
+- Include UTM parameters on all marketing links
+- A/B test subject lines and CTAs
+- GDPR/CAN-SPAM compliant
+- Track opens, clicks, conversions
+- Design drip sequences with conditions"
+
+# Agent: desktop-app-expert (Desktop App Specialist)
+AGENT_desktop_app_expert_TRIGGERS="electron tauri desktop native window tray ipc preload menu dmg nsis appimage code-sign notarize"
+AGENT_desktop_app_expert_DISPLAY="Desktop App Expert (desktop-app-expert)"
+AGENT_desktop_app_expert_SKILLS=""
+AGENT_desktop_app_expert_CONTEXT="Desktop App Guidelines:
+- Always use contextIsolation: true and sandbox: true
+- Never enable nodeIntegration in renderer
+- Expose only necessary APIs via contextBridge
+- Validate all IPC inputs in main process
+- Prevent directory traversal in file operations
+- Use electron-updater or tauri-updater for auto-updates
+- Code sign for macOS and Windows distribution
+- Test on all target platforms"
+
+# Agent: implementation-dev (General Implementation)
+AGENT_implementation_dev_TRIGGERS=""
+AGENT_implementation_dev_DISPLAY="Implementation Agent (implementation-dev)"
+AGENT_implementation_dev_SKILLS=""
+AGENT_implementation_dev_CONTEXT="Implementation Guidelines:
+- Follow existing patterns in the codebase
+- Keep changes minimal and focused
+- Test your changes before committing
+- Ask for clarification if requirements are unclear"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Agent Selection (Composable Routing)
+#
+# ARCHITECTURE: Domain specialists are "full-lifecycle" agents that handle
+# implementation, refactoring, architecture, testing, and hardening within
+# their domain. When a domain is detected, the specialist ALWAYS wins over
+# a generic workflow agent.
+#
+# Example: "refactor the Swift networking layer"
+#   → Routes to apple_swift_expert (NOT dry_refactor)
+#   → The specialist activates its "Refactoring Mode" internally
+#
+# Fallback: When no domain is detected, generic workflow agents handle it.
+#   "refactor the payment service" → dry_refactor (no domain detected)
+# ═══════════════════════════════════════════════════════════════════════════════
+
+AGENT_LIST="hardening_guard merlin_frontend merlin_api_designer system_architect tests_qa dry_refactor ops_railway docs_keeper merlin_debugger desktop_app_expert apple_swift_expert android_expert ui_designer ui_builder animation_expert marketing_automation implementation_dev"
+
+# Domain specialists: full-lifecycle agents with workflow_modes built in.
+# When these score ANY points, they get a +5 domain boost to beat generic agents.
+DOMAIN_SPECIALISTS="apple_swift_expert android_expert desktop_app_expert ui_designer ui_builder animation_expert marketing_automation"
+
+# Primary triggers score 3 points, secondary triggers score 1 point
+# Domain specialists also get +5 boost when scoring > 0
+
+AGENT_hardening_guard_PRIMARY="security auth login password encrypt 2fa oauth"
+AGENT_hardening_guard_SECONDARY="token jwt session hash rate-limit validate sanitize"
+
+AGENT_merlin_frontend_PRIMARY="ui component frontend react vue svelte"
+AGENT_merlin_frontend_SECONDARY="css layout responsive angular tailwind design"
+
+AGENT_merlin_api_designer_PRIMARY="api endpoint route rest graphql"
+AGENT_merlin_api_designer_SECONDARY="webhook handler controller middleware"
+
+AGENT_system_architect_PRIMARY="database schema model migration architecture"
+AGENT_system_architect_SECONDARY="structure service microservice"
+
+AGENT_tests_qa_PRIMARY="test spec coverage unit integration"
+AGENT_tests_qa_SECONDARY="e2e jest mocha pytest"
+
+AGENT_dry_refactor_PRIMARY="refactor cleanup dry organize"
+AGENT_dry_refactor_SECONDARY="structure split extract consolidate"
+
+AGENT_ops_railway_PRIMARY="deploy infra railway docker"
+AGENT_ops_railway_SECONDARY="env ci cd pipeline build"
+
+AGENT_docs_keeper_PRIMARY="docs readme documentation"
+AGENT_docs_keeper_SECONDARY="comment jsdoc typedoc markdown"
+
+AGENT_merlin_debugger_PRIMARY="debug fix error bug"
+AGENT_merlin_debugger_SECONDARY="issue crash trace log"
+
+AGENT_desktop_app_expert_PRIMARY="electron tauri desktop native ipc"
+AGENT_desktop_app_expert_SECONDARY="window tray preload menu dmg nsis appimage code-sign notarize"
+
+AGENT_apple_swift_expert_PRIMARY="swift swiftui appkit ios macos iphone"
+AGENT_apple_swift_expert_SECONDARY="ipad xcode cocoa uikit swiftdata coredata swift6"
+
+AGENT_android_expert_PRIMARY="android kotlin compose jetpack"
+AGENT_android_expert_SECONDARY="material gradle room hilt viewmodel coroutine play-store aab apk"
+
+AGENT_ui_designer_PRIMARY="design-system accessibility wcag visual-hierarchy ux"
+AGENT_ui_designer_SECONDARY="color-palette typography spacing wireframe mockup hig"
+
+AGENT_ui_builder_PRIMARY="shadcn radix component-library form table"
+AGENT_ui_builder_SECONDARY="card modal dialog sheet dropdown popover cva"
+
+AGENT_animation_expert_PRIMARY="animation motion framer gsap transition"
+AGENT_animation_expert_SECONDARY="scroll-animation parallax spring keyframe animate lottie"
+
+AGENT_marketing_automation_PRIMARY="email campaign drip marketing funnel"
+AGENT_marketing_automation_SECONDARY="newsletter automation conversion ab-test analytics tracking utm landing-page growth"
+
+AGENT_implementation_dev_PRIMARY=""
+AGENT_implementation_dev_SECONDARY=""
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Task Type Detection
+# Detects the workflow mode so domain specialists activate the right mode.
+# ═══════════════════════════════════════════════════════════════════════════════
+
+detect_task_type() {
+  local task_lower="$1"
+
+  # Check refactoring first (most specific action word)
+  for word in refactor cleanup dry reorganize split extract consolidate rename simplify; do
+    if echo "$task_lower" | grep -qw "$word"; then echo "REFACTORING"; return; fi
+  done
+
+  # Architecture / design
+  for word in architect design plan model schema structure service boundary module; do
+    if echo "$task_lower" | grep -qw "$word"; then echo "ARCHITECTURE"; return; fi
+  done
+
+  # Testing
+  for word in test spec coverage unit integration e2e qa verify assert; do
+    if echo "$task_lower" | grep -qw "$word"; then echo "TESTING"; return; fi
+  done
+
+  # Hardening / security
+  for word in harden secure security audit validate review sanitize vulnerability; do
+    if echo "$task_lower" | grep -qw "$word"; then echo "HARDENING"; return; fi
+  done
+
+  # Debugging
+  for word in debug fix error bug crash trace troubleshoot; do
+    if echo "$task_lower" | grep -qw "$word"; then echo "DEBUGGING"; return; fi
+  done
+
+  echo "IMPLEMENTATION"  # Default mode
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Agent Scoring
+# ═══════════════════════════════════════════════════════════════════════════════
+
+score_agent() {
+  local agent="$1"
+  local task_lower="$2"
+
+  local primary_var="AGENT_${agent}_PRIMARY"
+  local secondary_var="AGENT_${agent}_SECONDARY"
+  local triggers_var="AGENT_${agent}_TRIGGERS"
+  local primary="${!primary_var}"
+  local secondary="${!secondary_var}"
+  local triggers="${!triggers_var}"
+
+  local score=0
+
+  # Primary keywords: 3 points each (strong signal)
+  if [ -n "$primary" ]; then
+    for trigger in $primary; do
+      if echo "$task_lower" | grep -qw "$trigger"; then
+        score=$((score + 3))
+      fi
+    done
+  fi
+
+  # Secondary keywords: 1 point each (supporting signal)
+  if [ -n "$secondary" ]; then
+    for trigger in $secondary; do
+      if echo "$task_lower" | grep -qw "$trigger"; then
+        score=$((score + 1))
+      fi
+    done
+  fi
+
+  # Fallback: legacy triggers (1 point each, for backward compat)
+  if [ $score -eq 0 ] && [ -n "$triggers" ]; then
+    for trigger in $triggers; do
+      if echo "$task_lower" | grep -qw "$trigger"; then
+        score=$((score + 1))
+      fi
+    done
+  fi
+
+  echo $score
+}
+
+# Check if an agent is a domain specialist
+is_domain_specialist() {
+  local agent="$1"
+  for specialist in $DOMAIN_SPECIALISTS; do
+    if [ "$agent" = "$specialist" ]; then return 0; fi
+  done
+  return 1
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Main Routing: select_agent_for_task
+#
+# Two-pass routing:
+#   1. Score all agents with keyword matching
+#   2. Domain specialists get +5 boost when they score > 0
+#   This ensures "refactor swift code" → apple_swift_expert (not dry_refactor)
+#   But "refactor the code" → dry_refactor (no domain detected)
+# ═══════════════════════════════════════════════════════════════════════════════
+
+DOMAIN_BOOST=5
+
+select_agent_for_task() {
+  local task_description="$1"
+  local task_lower
+  task_lower=$(echo "$task_description" | tr '[:upper:]' '[:lower:]')
+
+  local best_agent="implementation_dev"
+  local best_score=0
+
+  for agent in $AGENT_LIST; do
+    # Skip the default agent (it's the fallback)
+    if [ "$agent" = "implementation_dev" ]; then continue; fi
+
+    local score
+    score=$(score_agent "$agent" "$task_lower")
+
+    # Domain boost: specialists get +5 when they score any points
+    # This ensures domain experts beat generic workflow agents
+    if [ $score -gt 0 ] && is_domain_specialist "$agent"; then
+      score=$((score + DOMAIN_BOOST))
+    fi
+
+    if [ $score -gt $best_score ]; then
+      best_score=$score
+      best_agent="$agent"
+    fi
+  done
+
+  echo "$best_agent"
+}
+
+get_agent_display_name() {
+  local agent="$1"
+  local display_var="AGENT_${agent}_DISPLAY"
+  echo "${!display_var:-$agent}"
+}
+
+# Map internal agent ID to Claude Code --agent flag name
+# Internal IDs use underscores, Claude agent files use hyphens
+get_agent_cli_name() {
+  local agent="$1"
+
+  # Map internal agent ID → .claude/agents/ filename (without .md)
+  case "$agent" in
+    hardening_guard)     echo "hardening-guard" ;;
+    merlin_frontend)     echo "merlin-frontend" ;;
+    merlin_api_designer) echo "merlin-api-designer" ;;
+    system_architect)    echo "system-architect" ;;
+    tests_qa)            echo "tests-qa" ;;
+    dry_refactor)        echo "dry-refactor" ;;
+    ops_railway)         echo "ops-railway" ;;
+    docs_keeper)         echo "docs-keeper" ;;
+    merlin_debugger)     echo "merlin-debugger" ;;
+    desktop_app_expert)  echo "desktop-app-expert" ;;
+    apple_swift_expert)  echo "apple-swift-expert" ;;
+    android_expert)      echo "android-expert" ;;
+    ui_designer)         echo "ui-designer" ;;
+    ui_builder)          echo "ui-builder" ;;
+    animation_expert)    echo "animation-expert" ;;
+    marketing_automation) echo "marketing-automation" ;;
+    implementation_dev)  echo "implementation-dev" ;;
+    *)                   echo "merlin" ;;  # fallback to generalist
+  esac
+}
+
+get_agent_required_skills() {
+  local agent="$1"
+  local skills_var="AGENT_${agent}_SKILLS"
+  echo "${!skills_var}"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Full-Merge Composition
+#
+# When a domain specialist handles a workflow task (refactor, test, etc.),
+# we inject the ENTIRE workflow agent's system prompt as additional context.
+# This gives the specialist BOTH deep domain knowledge AND deep methodology.
+#
+# Example: "refactor Swift networking"
+#   → Agent: apple-swift-expert.md (loaded via --agent flag = full Swift expertise)
+#   → Context: dry-refactor.md (injected here = full refactoring methodology)
+#   → Claude gets 488 + 258 = 746 lines of combined expertise
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Map task type → workflow agent file path
+get_workflow_agent_file() {
+  local task_type="$1"
+  local agents_dir="$HOME/.claude/agents"
+
+  case "$task_type" in
+    IMPLEMENTATION) echo "$agents_dir/implementation-dev.md" ;;
+    REFACTORING)    echo "$agents_dir/dry-refactor.md" ;;
+    ARCHITECTURE)   echo "$agents_dir/system-architect.md" ;;
+    TESTING)        echo "$agents_dir/tests-qa.md" ;;
+    HARDENING)      echo "$agents_dir/hardening-guard.md" ;;
+    DEBUGGING)      echo "$agents_dir/merlin-debugger.md" ;;
+    *)              echo "" ;;
+  esac
+}
+
+get_agent_context_injection() {
+  local agent="$1"
+  local task_description="${2:-}"
+  local context_var="AGENT_${agent}_CONTEXT"
+  local context="${!context_var}"
+
+  # Full-merge: for domain specialists, inject the ENTIRE workflow agent
+  if [ -n "$task_description" ] && is_domain_specialist "$agent"; then
+    local task_lower
+    task_lower=$(echo "$task_description" | tr '[:upper:]' '[:lower:]')
+    local task_type
+    task_type=$(detect_task_type "$task_lower")
+    local workflow_file
+    workflow_file=$(get_workflow_agent_file "$task_type")
+
+    if [ -n "$workflow_file" ] && [ -f "$workflow_file" ]; then
+      local workflow_content
+      workflow_content=$(cat "$workflow_file")
+
+      context="${context}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# MERGED WORKFLOW AGENT: ${task_type} MODE
+#
+# You are a domain specialist handling a ${task_type,,} task.
+# The full methodology agent has been merged into your context below.
+# Apply these patterns and principles using YOUR domain expertise.
+# Your domain knowledge takes precedence for technology-specific decisions.
+# The workflow methodology guides HOW you work, not WHAT technology you use.
+# ═══════════════════════════════════════════════════════════════════════════
+
+${workflow_content}"
+    fi
+  fi
+
+  echo "$context"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Skill Detection
+# ═══════════════════════════════════════════════════════════════════════════════
+
+detect_skills_from_task() {
+  local task_description="$1"
+  local task_lower
+  task_lower=$(echo "$task_description" | tr '[:upper:]' '[:lower:]')
+  local detected=""
+
+  # Skill mappings
+  if echo "$task_lower" | grep -qE "image|avatar|upload|crop|canvas"; then
+    detected="${detected}canvas-design
+"
+  fi
+
+  if echo "$task_lower" | grep -qE "payment|stripe|billing|checkout"; then
+    detected="${detected}payment-patterns
+"
+  fi
+
+  if echo "$task_lower" | grep -qE "websocket|realtime|socket|notification"; then
+    detected="${detected}websocket-patterns
+"
+  fi
+
+  if echo "$task_lower" | grep -qE "chart|graph|visualization|dashboard|analytics"; then
+    detected="${detected}data-visualization
+"
+  fi
+
+  if echo "$task_lower" | grep -qE "email|smtp|sendgrid|mailgun"; then
+    detected="${detected}email-patterns
+"
+  fi
+
+  echo "$detected"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Skill Management
+# ═══════════════════════════════════════════════════════════════════════════════
+
+get_installed_skills() {
+  # Check ~/.claude/skills/ for installed skills
+  local skills_dir="$HOME/.claude/skills"
+  if [ -d "$skills_dir" ]; then
+    ls "$skills_dir" 2>/dev/null | sed 's/\.md$//'
+  fi
+}
+
+install_skill() {
+  local skill="$1"
+
+  # Try to install via npx claude-code-templates
+  if command -v npx &> /dev/null; then
+    npx claude-code-templates@latest --skill "$skill" 2>/dev/null
+    return $?
+  fi
+
+  return 1
+}