DOCS/skills/SKILL.md

---
name: robeing-skills-overview
description: 로빙(robeing)이 보유한 모든 스킬의 요약 및 의도 분석 컨텍스트. 사용자 의도 파악 시 어떤 스킬을 호출할지 결정하는 참고 문서.
tags: [robeing, skills, ssot]
---

# 로빙 스킬 문서 요약

로빙이 사용할 수 있는 스킬 목록과 각 스킬의 역할·트리거를 요약합니다. 의도 분석 시 이 문서를 컨텍스트로 활용할 수 있습니다.

- **SSOT**: [project-artifacts-ssot.md](/home/admin/0_VALUE/20_Governance/project-artifacts-ssot.md) — 스킬 문서는 `DOCS/skills/{skill-name}/SKILL.md` 규칙 준수

## 스킬 목록 (링크)

| 스킬 | 포트 | 역할 | 상세 문서 |
|------|------|------|-----------|
| **skill-email** | 8501 | Gmail 읽기/쓰기 | [skill-email/SKILL.md](skill-email/SKILL.md) |
| **skill-news** | 8505 | 뉴스 수집·AI 요약 | [skill-news/SKILL.md](skill-news/SKILL.md) |
| **skill-slack** | 8502 | Slack 대화 요약·액션 추출 | [skill-slack/SKILL.md](skill-slack/SKILL.md) |
| **skill-calendar** | 8512 | Google/Slack/네이버웍스 캘린더 | [skill-calendar/SKILL.md](skill-calendar/SKILL.md) |
| **skill-rag-file** | 8508 | PDF/DOCX RAG·문서 검색 | [skill-rag-file/SKILL.md](skill-rag-file/SKILL.md) |
| **skill-embedding** | 8515 | 텍스트 임베딩·감정 분류 | [skill-embedding/SKILL.md](skill-embedding/SKILL.md) |
| **skill-llm** | (내장) | 일반 대화·생성 | [skill-llm/SKILL.md](skill-llm/SKILL.md) |
| **companyx-rag** | (skill-rag-file) | Company X 내부 문서 근거 검색 | [companyx-rag/SKILL.md](companyx-rag/SKILL.md) |
| **goosefarm-query** | 8200 | GooseFarm 배당·금·부동산·환율·암호화폐·M2 조회 | [goosefarm-query/SKILL.md](goosefarm-query/SKILL.md) |
| **github-analyze** | (내장) | GitHub 레포 분석·코드 리뷰(읽기)·구조·커밋 히스토리 | [github-analyze/SKILL.md](github-analyze/SKILL.md) |
| **github-manage** | (내장) | PR·이슈·브랜치 등 GitHub 호스팅 관리 | [github-manage/SKILL.md](github-manage/SKILL.md) |
| **git-ops** | (내장) | git clone/pull/push/commit 실행 | [git-ops/SKILL.md](git-ops/SKILL.md) |
| **skill-translate** | (내장) | 언어 번역 및 변환 | [skill-translate/SKILL.md](skill-translate/SKILL.md) |
| **session-logs** | (내장, 8001) | 과거 대화 검색·토큰 비용 집계 | [session-logs/SKILL.md](session-logs/SKILL.md) |
| **blogwatcher** | (skill-news, 8505) | RSS/블로그 피드 구독·새 글 모니터링 | [blogwatcher/SKILL.md](blogwatcher/SKILL.md) |
| **summarize** | 8516 | URL/유튜브/텍스트 요약 | [summarize/SKILL.md](summarize/SKILL.md) |
| **whisper** | 8517 | 음성→텍스트 변환 | [whisper/SKILL.md](whisper/SKILL.md) |
| **gitea** | 8518 | Gitea 레포/이슈/PR 관리 | [gitea/SKILL.md](gitea/SKILL.md) |
| **himalaya** | (skill-email, 8501) | IMAP/SMTP 범용 메일 (Gmail 외) | [himalaya/SKILL.md](himalaya/SKILL.md) |
| **skill-creator** | (스크립트) | 새 스킬 서비스 스캐폴딩 | [skill-creator/SKILL.md](skill-creator/SKILL.md) |

## 의도 → 스킬 매핑 (요약)

| 사용자 의도 | 호출 스킬 |
|-------------|-----------|
| 이메일 읽기/쓰기/요약 | skill-email |
| 뉴스 검색·요약 | skill-news |
| Slack 스레드 요약·액션 추출 | skill-slack |
| 일정 등록/조회/삭제 | skill-calendar |
| 문서 분석·RAG 검색 | skill-rag-file |
| Company X 내부 문서 근거 | companyx-rag (skill-rag-file) |
| GooseFarm 시장·자산 데이터(배당·금·부동산·환율·코인·M2) | goosefarm-query |
| GitHub 레포 분석·코드 리뷰(읽기)·구조 파악 | github-analyze |
| PR·이슈·브랜치 관리(GitHub) | github-manage |
| git clone/pull/push/commit 실행 | git-ops |
| 실시간 웹 검색 (날씨/주가/환율/시세/뉴스) | web-search |
| 사용자 정보/시간/날짜/자기 코드/드래프트/과거 대화 | self-inspect |
| 일반 대화·정보 질의 | skill-llm (내장) |
| 번역 및 언어 변환 | skill-translate |
| 과거 대화 검색·토큰 비용 확인 | session-logs |
| RSS/블로그 구독·새 글 확인 | blogwatcher (skill-news) |
| URL/유튜브/텍스트 요약 | summarize |
| 음성 파일 텍스트 변환 | whisper |
| Gitea 이슈/PR/레포 관리 | gitea (provider=gitea) |
| GitHub 이슈/PR/레포 관리 | gitea (provider=github) |
| IMAP/SMTP 메일 (Gmail 외) | himalaya (skill-email) |

## Company X RAG 실행 계약

- 의도명 SSOT: `companyx_rag`
- 스킬 문서 SSOT: `companyx-rag`
- 실행 계획 계약: `RAG/companyx_search`
- 해석 기준: 의도 분류에서는 `companyx-rag` 스킬 설명을 참고하지만, 실행 레이어에서는 Company X 내부 문서 근거 요청을 `RAG` 스킬의 `companyx_search` 액션으로 보존합니다. 이 값은 `skill-llm`의 `task_type` alias가 아닙니다.

## 파일 첨부 → 1차 라우팅

**원칙**: 최종 라우팅은 본 문서(SKILL.md)의 스킬 정의·트리거와 **브레인(LLM 의도분류)**가 함께 담당한다. 아래 표는 파일 메타 기준 **참고 힌트**이며, 특히 혼합 첨부처럼 단일 스킬이 자명하지 않은 경우 **표의 한 행으로 결과(예: `needs_clarify` 고정)를 미리 확정하지 않는다.**

| 파일군 | 대표 확장자 | MIME 상위 | 1차 스킬 | 비고 |
|--------|-------------|-----------|----------|------|
| 문서 | `pdf`, `docx`, `doc`, `xlsx`, `xls`, `pptx`, `ppt`, `txt`, `md`, `csv`, `tsv`, `json`, `xml`, `html`, `htm` | `application/pdf`, `application/vnd.*`, `text/*`, `application/json` | `skill-rag-file` | 이미지 내장 PDF OCR은 `skill-rag-file` 내부 처리 |
| 오디오 | `m4a`, `mp3`, `wav`, `aac`, `ogg`, `flac`, `opus`, `webm` | `audio/*` | `whisper` | `application/octet-stream`이어도 확장자가 오디오면 오디오로 본다 |
| 이미지 단독 | `jpg`, `jpeg`, `png`, `webp`, `gif` | `image/*` | 미지원 | 비전 스킬 미구현 상태에서는 라우팅하지 않음 |
| 압축 | `zip`, `7z`, `rar`, `tar` | `application/zip` 등 | 미지원 | 안전 정책상 직접 처리하지 않음 |
| 실행·바이너리 | `exe`, `dmg`, `app`, `sh`, `bat`, `bin` | `application/x-*` 등 | 미지원 | 문서·오디오 스킬로 라우팅하지 않음 |
| 혼합 첨부 | 문서+오디오 등 | 혼합 | — | **브레인(의도분류)**이 맥락·의도에 따라 후보 스킬·`needs_clarify` 등을 판단한다. 문서와 오디오를 한 스킬로 억지 병합하지 않는다는 제약은 각 스킬 `SKILL.md`를 따른다. |

`whisper` ↔ `skill-rag-file`: 오디오는 먼저 `whisper`로 전사하고, 전사 결과를 문서 인덱싱·검색으로 이어갈 때 `skill-rag-file`이 다음 후보입니다.

## 상세 스킬 문서

각 스킬의 트리거, Do/Do Not, API 경로 등은 위 링크의 상세 문서를 참조하세요.

## 관련 문서

- [project-artifacts-ssot.md](/home/admin/0_VALUE/20_Governance/project-artifacts-ssot.md)
- [robeing DOCS 구조](/home/admin/robeing/DOCS/)