SoulFlow-Orchestrator

Create new skills, modify and improve existing skills, and validate skill structure. Use when users want to create a skill from scratch, update or optimize an existing skill, restructure SKILL.md for better triggering, or add scripts/references/assets. Do NOT use for general coding tasks, when the user just wants to use an existing skill, or when a builtin skill already covers the use case (check src/skills/ first).

워크플로우 설계 전문. 프로바이더/백엔드 구성, 에이전트 프롬프트 작성, 노드 할당, 실시간 반복 수정까지 end-to-end 워크플로우 생성·편집. Use when 사용자가 자동화 워크플로우를 만들거나 수정하려 할 때, 멀티에이전트 파이프라인을 구성할 때, closed-loop 품질 게이트가 필요할 때, 기존 워크플로우에 단계를 추가/변경/삭제할 때. Do NOT use for 단순 워크플로우 실행(이미 정의가 있으면 바로 run).

Baseline task skill example for .claude/skills/. Use as a reference template when authoring task skills. Do NOT use for builtin skills -- those go in src/skills/.

Generate map links for places, addresses, and points of interest. Use when the user mentions a location, asks for directions, or wants nearby recommendations (restaurants, cafes, etc.). Supports Google Maps, Kakao Map, and Naver Map.

Gateway direct execution 설계/구현 전문. 채널 요청을 `builtin`, `direct_tool`, `model_direct`, `workflow_compile`, `workflow_run`, `agent_required`로 분류하고, 가능한 경로는 에이전트 없이 직접 실행하도록 경계를 정리한다. Use when 게이트웨이/오케스트레이션 분리, direct tool path, model-direct path, RequestPlan, ExecutionGateway, ResultEnvelope, requested channel affinity 작업을 수행할 때. Do NOT use for phase loop 내부 구현, workflow state machine 자체 수정, 단순 프롬프트 문구 조정만 필요한 작업.

Role protocol architecture 설계/구현 전문. `src/skills/roles/*/SKILL.md`를 source of truth로 유지하면서 `RolePolicyResolver`, `ProtocolResolver`, `PromptProfileCompiler`로 역할 정책을 구조화한다. Use when 역할 기준을 런타임·워크플로우 생성기·에이전트 생성 UI가 공통으로 사용해야 할 때, `shared_protocols`를 실제 정책으로 해석해야 할 때, role baseline과 persona/task override를 분리해야 할 때. Do NOT use for 단순 문자열 prompt 조합, 한 역할의 문구만 수정하는 작업, user-facing deterministic renderer만 수정하는 작업.

디버깅 전문. 버그 추적, 근본 원인 분석(RCA), 수정 제안. Use when 버그/에러가 발생하여 원인 분석이 필요할 때. Do NOT use for 신규 기능 구현 — implementer 역할.

코드 구현 전문. 스펙 기반 파일 수정 + 셀프 검증. Use when 스펙이 확정된 코드 작성/수정 작업. Do NOT use for 설계, 리뷰, CI 실행 — 각각 PM, reviewer, validator 역할.

코드 리뷰 전문. 품질, 보안, 성능, 컨벤션 검토. Use when 구현 완료 후 코드 검토가 필요할 때. Do NOT use for 코드 작성 — implementer 역할.

Web search and browser automation using web_search, web_fetch, and web_browser tools. Use when: internet lookup, latest/real-time information, cross-source verification, any URL mentioned by user, dynamic page interaction, web crawling, site analysis, news search, price check, documentation lookup. Do NOT use for local file operations or tasks requiring no internet access.

Generate Mermaid diagrams (flowcharts, sequence, ERD, class, state, gantt, pie, mindmap) as SVG or ASCII using the builtin diagram_render tool. Use when the user asks for architecture diagrams, visual charts, or mentions Mermaid syntax. Do NOT use for image generation, screenshots, or non-diagram visuals.

Generate structured files (PDF, PPTX, DOCX, XLSX, ZIP) using Python inside a container sandbox. Use when the user asks to create, export, or generate a document, report, spreadsheet, presentation, or archive. After creation, use file-delivery skill to send the file. When explicitly requested, can also package multiple files into a ZIP archive before delivery. Do NOT use for plain text/markdown/CSV (use write_file directly), diagrams (use diagram skill), or viewing/reading existing files. Do NOT create ZIP unless user explicitly asks for it.

Interact with GitHub using the gh CLI for issues, pull requests, CI/CD runs, releases, and API queries. Use when the user mentions GitHub, PRs, issues, CI checks, workflow runs, or references a GitHub URL. Do NOT use for generic git operations (use just-bash) or non-GitHub platforms.

Efficient shell execution using the exec tool with automatic just-bash runtime. Use for any local computation, file inspection, system commands, git operations, or CLI tools. Always available as the default execution pathway. Do NOT use for interactive TTY (use tmux) or container isolation (use python-sandbox or temp-db).

Execute any dependency-requiring task inside ephemeral containers (podman/docker) with automatic cleanup. Use for Python scripts (pip packages), SQLite/DuckDB local DB, PostgreSQL/MySQL connections, or any tool requiring system packages. Container is pulled, used, and removed — nothing stays on host. Do NOT use for simple shell commands with no external dependencies (use just-bash instead).

사용자 직접 대면. 일상 작업 처리, 개발 작업 감지 시 PM/PL에 위임. Use when 일반 질문, 검색, 정보 정리, 번역 등 비개발 작업. Do NOT use for 직접 코드 작성/수정 — 개발 작업은 PM/PL에 위임.

한글(HWPX) 문서 생성/읽기/편집. .hwpx 파일, 한글 문서, Hancom, OWPML 관련 요청 시 사용. 컨테이너(sandbox) 안에서 Python + lxml로 실행. Do NOT use for .hwp(바이너리) — .hwpx만 지원.

기획 전담. 요구사항 분석, 스펙 작성, 우선순위 결정. Use when 복잡한 작업의 기획/분석이 필요할 때. Do NOT use for 직접 코드 작성, 직접 실행 — PL에게 위임.

Search and install agent skills from ClawHub, the public skill registry. Use when the user asks to find, install, update, or list available skills. No API key needed. Do NOT use for creating skills (use skill-creator) or managing locally installed skills.

Schedule reminders, recurring tasks, and one-time notifications using the cron tool. Use when the user asks to set a reminder, schedule a recurring task, create a timer, or wants periodic execution. Also use for listing or removing existing schedules. Do NOT use for immediate one-off actions that need no scheduling.

Summarize or extract text from URLs, local files, YouTube videos, and podcasts using the summarize CLI. Use when the user asks to summarize a link, article, video, or document. Supports multiple output lengths and models. Do NOT use for web search (use web-search) or for content the agent can read directly.

Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output. Use when the task needs an interactive TTY: Python REPLs, long-running processes, or orchestrating multiple agents in parallel. Requires tmux on PATH (macOS/Linux, WSL on Windows). Do NOT use for simple non-interactive commands (use just-bash).

범용 서브에이전트. 전문 역할이 불필요한 단일 작업 처리. Use when 단순 질문 응답, 파일 탐색, 정보 수집, 분류 불가 작업. Do NOT use for 복잡한 구현, 리뷰, 디버깅 — 전문 역할 사용.

실행 조율 전담. 개발팀 spawn, 진행 감독, Phase Gate 판정, 결과 검증. Use when PM 스펙 수신 후 개발 실행이 필요할 때. Do NOT use for 기획/스펙 작성 — PM 역할.

검증 전문. 빌드, 테스트, lint 실행 및 결과 판정. Use when 구현/리뷰 완료 후 최종 검증이 필요할 때. Do NOT use for 코드 작성/리뷰 — implementer, reviewer 역할.

Send files (PDF, images, documents) to the current channel using send_file tool. Use when the user asks to attach, deliver, upload, or send a generated file. Do NOT use for requesting files FROM users (use request_file), text-only messages (use message), or diagram rendering (use diagram).

Get current weather conditions and forecasts for any location using Open-Meteo API with KMA (Korea Meteorological Administration) data. No API key required. High-resolution 1.5km model for Korea. Use when the user asks about weather, temperature, rain, snow, humidity, wind, or forecasts. Do NOT use for historical weather data or climate analysis.

Two-layer persistent memory system (longterm facts + daily recall) backed by memory.db. Use when the user mentions remembering, recalling past events, storing preferences, or asks about past context. Also use automatically to persist important user preferences, project facts, and relationship data. Do NOT use for ephemeral session data.