스킬 시스템
스킬(Skill)은 Starnion AI 에이전트의 능력 모듈입니다. 각 스킬은 특정 기능을 담당하는 독립된 도구로, 필요에 따라 켜고 끌 수 있습니다.
스킬이란?
AI가 단순히 대화만 하는 것이 아니라 실제로 무언가를 실행할 수 있도록 해주는 기능 단위입니다.
예를 들어:
점심 12,000원→ finance 스킬이 가계부에 기록오늘 일기 써줘→ diary 스킬이 일기 작성영수증 사진→ image 스킬이 금액을 추출 → finance 스킬이 자동 기록이번 달 운동 목표 달성!→ goals 스킬이 목표 진행 업데이트
사용자가 명시적으로 스킬 이름을 언급하지 않아도, AI가 문맥을 파악하여 적절한 스킬을 자동으로 선택합니다.
스킬 활성화 / 비활성화
설정 > 스킬(Skills) 메뉴에서 각 스킬을 개별적으로 켜고 끌 수 있습니다.
- 비활성화된 스킬은 AI가 요청을 받아도 해당 기능을 실행하지 않습니다.
- 일부 핵심 스킬(시스템 스킬)은 비활성화할 수 없습니다.
- 스킬 설정은 계정별로 저장됩니다.
스킬 상세 패널
설정 > 스킬의 각 스킬 카드에는 ⓘ 버튼이 있습니다. 클릭하면 사이드 패널이 열리며 다음 정보를 확인할 수 있습니다:
- 설명 — 스킬이 하는 일
- 트리거 키워드 — 메시지에 이 단어가 포함되면 스킬이 자동으로 활성화됨
- 사용 예시 — 채팅에 바로 보낼 수 있는 복사 가능한 예시
상세 패널에서 스킬을 바로 활성화하거나 비활성화할 수도 있습니다.
전체 스킬 목록
재무 (Finance)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
finance |
가계부 | 지출·수입을 자동 기록. “점심 12,000원”, “월급 받았어” 같은 메시지에 반응 | ✓ |
budget |
예산 관리 | 카테고리별 월 예산 설정·변경 및 사용 현황 조회 | ✓ |
pattern |
소비 패턴 분석 | 요일별 소비 경향, 반복 결제, 소비 속도를 백그라운드에서 자동 분석 | ✓ |
proactive |
능동 알림 | 예산 초과 경고, 이상 소비 감지 등 AI가 먼저 알림을 보내는 기능 | ✓ |
currency |
환율 | 실시간 환율 조회 및 통화 변환 | ✓ |
개인 기록 (Personal)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
diary |
일기 | 일상·감정·생각 기록. “오늘 기분이 좋아”, “회의가 길었어” 등 비금전적 메시지에 반응 | ✓ |
memo |
메모 | 제목·태그가 있는 메모 저장, 목록 조회, 삭제 | ✓ |
goals |
목표 관리 | 재정 목표, 할 일, 습관, 개인 목표 설정 및 진행 상황 추적 | ✓ |
dday |
디데이 | 중요한 날짜까지 남은 일수 추적, 매년 반복 설정 가능 | ✓ |
reminder |
알림 | 특정 시각에 알림 예약. “내일 오전 9시에 회의 알려줘” | ✓ |
schedule |
스케줄 | 정기 또는 일회성 알림 스케줄 생성·관리. 반복 알림 지원 | ✓ |
memory |
기억 검색 | 과거 대화·가계부·일기·문서를 시맨틱 검색으로 통합 조회 | ✓ |
미디어 (Media)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
image |
이미지 분석·생성 | 이미지 분석, AI 이미지 생성·편집, 영수증 자동 파싱 | ✓ |
audio |
음성 변환 | 음성 메시지를 텍스트로(STT), 텍스트를 음성으로(TTS) 변환 | ✓ |
video |
비디오 분석 | 비디오 내용 요약, 장면 설명, AI 이미지 슬라이드쇼 영상 생성 | - |
documents |
문서 관리 | PDF·Word 등 문서 파싱 및 벡터 DB 저장, 문서 생성 | ✓ |
qrcode |
QR코드 생성 | URL·텍스트로 QR 코드 이미지 생성 | ✓ |
검색 (Search)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
websearch |
웹 검색 | Tavily API로 인터넷에서 최신 정보 검색 및 웹페이지 내용 가져오기 | ✓ |
naver_search |
네이버 검색 | 네이버 Open API로 쇼핑·블로그·뉴스·책·지식iN·지역 검색 | - |
weather |
날씨 | 현재 날씨와 일기예보 조회 | ✓ |
summarize |
요약 | URL 웹페이지나 텍스트를 AI로 요약. 간결/상세/항목별 스타일 선택 가능 | ✓ |
도구 (Utilities)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
calculator |
계산기 | 수학 수식 계산. 사칙연산, sin/cos/log 등 수학 함수 지원 | ✓ |
translate |
번역 | 텍스트를 지정 언어로 번역. 언어 자동 감지 지원 | ✓ |
currency |
환율 변환 | 실시간 환율 기반 통화 변환 | ✓ |
timezone |
세계시간 | 세계 각 도시 현재 시간 조회, 시간대 변환 | ✓ |
unitconv |
단위변환 | 길이·무게·온도·속도·넓이 등 단위 변환 | ✓ |
color |
색상 변환 | HEX·RGB·HSL 색상 코드 상호 변환 | ✓ |
encode |
인코딩 | Base64·URL·HTML 인코딩·디코딩 | ✓ |
hash |
해시 | MD5·SHA-1·SHA-256 해시값 생성 | ✓ |
wordcount |
글자수 | 글자수·단어수·문장수·바이트수 분석 | ✓ |
random |
랜덤 | 랜덤 선택, 숫자 뽑기, 동전 던지기, 주사위 굴리기 | ✓ |
ip |
IP 조회 | IP 주소 또는 도메인의 위치·ISP 정보 조회 | ✓ |
외부 연동 (Integrations)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
google |
구글 연동 | 구글 캘린더·문서·태스크·드라이브·메일 연동. OAuth2 인증 필요 | - |
browser |
브라우저 제어 | 웹 브라우저 자동 제어. URL 탐색·클릭·스크린샷·페이지 읽기 | - |
notion |
Notion 연동 | Notion 페이지 검색·생성·조회, 블록 추가, 데이터베이스 쿼리, 속성 업데이트. 인테그레이션 토큰 필요. | - |
github |
GitHub 연동 | 리포지토리·이슈·PR 조회, 이슈 생성, 코드 검색. 개인 액세스 토큰 필요. | - |
기타
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
horoscope |
운세 | 오늘의 별자리 운세 조회 | ✓ |
시스템 (System)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
usage |
사용량 요약 | AI 사용 통계 조회 — 요청 수, 토큰, 비용, 모델별·일별 내역 | ✓ |
개발 (Development)
| 스킬 ID | 스킬 이름 | 설명 | 기본 활성화 |
|---|---|---|---|
coding_agent |
코딩 에이전트 | Claude Code CLI에 코딩 작업 위임: 기능 구현, 리팩토링, 테스트 작성, README 생성 | - |
자연어로 스킬 호출하기
스킬을 직접 명령하지 않아도 됩니다. 자연스럽게 말하면 AI가 적절한 스킬을 선택합니다.
나: 달러 5만원으로 바꾸면 얼마야?
봇: 현재 환율(1,340원/달러) 기준으로 50,000원 = 약 37.31달러입니다.
나: 런던 지금 몇 시야?
봇: 런던(GMT) 현재 시간은 오전 6:42입니다.
나: 오늘 기분이 너무 안 좋아. 팀장한테 혼났어.
봇: 오늘 힘드셨겠네요. 일기에 기록해 두었습니다.
나: 내일 오후 3시에 병원 예약 잊지 말라고 알려줘.
봇: 내일 오후 3시에 "병원 예약" 알림을 설정했습니다.
나: 이 이미지에 뭐가 있어? (사진 첨부)
봇: 이미지를 분석했습니다. 커피숍 영수증으로 보이며, 아메리카노 4,500원이 결제되었습니다.
나: https://news.ycombinator.com 요약해줘.
봇: 해당 페이지를 요약했습니다. 현재 주요 게시물: ...
스킬 권한 안내
일부 스킬은 외부 API 키 또는 OAuth 인증이 필요합니다.
| 스킬 | 필요한 설정 |
|---|---|
weather |
날씨 API 키 (환경변수 설정) |
websearch |
Tavily API 키 |
naver_search |
네이버 Client ID / Secret |
google |
Google OAuth2 인증 완료 |
image |
OpenAI API 키 (이미지 생성 시) |
currency |
환율 API 키 |
notion |
Notion 인테그레이션 토큰 |
github |
GitHub 개인 액세스 토큰 |
coding_agent |
Claude Code CLI (서버 환경) |
API 키 설정은 서버 관리자가 .env 파일에서 구성합니다.
향후 추가 예정 스킬 (Phase 2)
다음 스킬들이 개발 계획에 있습니다:
| 스킬 | 설명 |
|---|---|
video |
실시간 스트리밍 분석 |
slack |
Slack 채널 연동 |
자주 묻는 질문
Q. 비활성화한 스킬의 데이터는 삭제되나요? 아니요. 스킬을 비활성화해도 기존 데이터는 그대로 유지됩니다. 다시 활성화하면 이전 데이터를 그대로 사용할 수 있습니다.
Q. 시스템 스킬은 무엇인가요?
memory, proactive 등 에이전트의 핵심 동작에 필요한 스킬입니다. 이 스킬들은 비활성화할 수 없습니다.
Q. 스킬을 여러 개 동시에 사용할 수 있나요?
네. 하나의 메시지로 여러 스킬이 순서대로 실행될 수 있습니다. 예를 들어 영수증 이미지를 보내면 image 스킬이 금액을 인식하고, finance 스킬이 자동으로 가계부에 기록합니다.