스킬이란?
스킬은 에이전트가 상황에 맞춰 자동으로 호출하는 재사용 가능한 지시 묶음입니다. 사용자가 미리 정의해두면, 에이전트가 대화 흐름에서 적절한 스킬을 판단해 실행합니다.
에이전트가 상황에 맞춰 호출하는 재사용 가능한 지시 묶음
에이전트 권한 필요
스킬은 이너릿 기능의 일부이므로 에이전트 런타임 권한이 필요합니다.
- 권한이 있는 사용자 — 사이드바에서 스킬 메뉴를 정상적으로 사용할 수 있습니다.
- 권한이 없는 사용자 — 사이드바의 스킬 메뉴에 🔒 자물쇠 아이콘이 표시되며 비활성화됩니다. 클릭하면 에이전트 권한 요청 다이얼로그가 열립니다.
권한 요청 후 관리자가 승인하면 스킬 메뉴가 즉시 활성화됩니다. 자세한 내용은 관리자 가이드 → 런타임 권한 을 참고하세요.
예시 스킬:
- "코드 리뷰" 스킬 — 코드 첨부 시 자동 발동
- "주간 보고서" 스킬 — "주간 보고서" 키워드 감지 시 발동
- "번역" 스킬 — 번역 요청 감지 시 한국어↔영어 자동 적용
스킬 만들기
- 좌측 메뉴에서 스킬 (
/skills) 로 이동합니다. - 새 스킬 (
/skills/new) 버튼을 클릭합니다. - 다음 필드를 입력합니다.
[!IMPORTANT] 스킬 이름은 소문자·숫자·하이픈, 3~50자 로만 만들 수 있고 생성 후 변경할 수 없습니다.
이름 & 설명
- 이름 — 스킬의 이름 (예:
code-reviewer) - 설명 — 스킬이 하는 일 (에이전트가 이해하는 데 사용)
트리거 (선택)
쉼표로 구분. 에이전트가 이 키워드를 만나면 스킬을 실행합니다
이 스킬을 발동시킬 키워드를 쉼표로 구분해 입력합니다.
예: 코드 리뷰, 리뷰해 줘, 코드 점검
본문 (Markdown)
스킬 본문은 마크다운으로 작성하며, 편집 화면은 좌측 에디터 / 우측 실시간 미리보기 2단 구성입니다. 에이전트가 이 스킬을 호출했을 때 따르게 될 상세 지시입니다.
예시:
## 코드 리뷰 스킬
코드를 리뷰할 때 다음 기준을 적용:
1. 가독성 — 이름, 구조, 주석
2. 성능 — 복잡도, 불필요한 연산
3. 보안 — 입력 검증, 권한
4. 테스트 — 커버리지, 엣지 케이스
리뷰 결과를 마크다운 표로 정리해 줘.
스킬 AI 어시스턴트
스킬 작성을 돕는 AI 어시스턴트 가 내장되어 있습니다.
스킬 이름·설명·트리거를 자동 채웠어요
지원 액션:
- 이 스킬 본문을 더 명확하고 실용적으로 다듬어 줘
- 이 스킬 본문을 섹션으로 구조화해 줘
- 이 스킬에 사용 예시를 추가해 줘
- 이 스킬이 발동될 만한 트리거를 제안해 줘
필요하면 웹 검색과 이미지 검색(이미지 후보 제안)으로 자료를 반영해 작성하게 할 수도 있고, 결과를 사이드바/모달로 띄워두며 작업할 수도 있습니다. 완성본은 저장하면 자동으로 에이전트에 전파되며, 전송이 완료되면 "스킬 …이(가) 에이전트로 전송되었습니다" 알림을 받습니다.
본문을 대충 적어넣고 AI에게 다듬게 하는 것도 좋은 워크플로우입니다.
스킬 목록
목록에는 각 스킬의 출처(사용자가 만든 것 / 에이전트가 만든 것)와 동기화 상태가 함께 표시됩니다.
에이전트 동기화
스킬을 저장하면 나의 에이전트 작업 환경으로 자동 동기화됩니다.
에이전트 동기화는 백그라운드에서 진행 중입니다
- 양방향 동기화: 내가 저장한 스킬은 에이전트로 push되고, 에이전트가 수정한 스킬은 다시 서버로 pull됩니다.
- 동기화는 백그라운드에서 비동기로 진행되므로 즉시 반영되지 않을 수 있습니다.
스킬 관리
- 목록 (
/skills) — 모든 스킬 보기 - 수정 (
/skills/:id/edit) — 본문, 트리거, 설명 업데이트 - 삭제 — 더 이상 필요 없는 스킬 제거
다음 단계
- 도구 등록 — 스킬과 함께 에이전트를 확장하는 도구
- 에이전트 작업 환경 — 스킬이 동기화되는 환경
목록 조회와 수동 동기화
스킬 목록은 DB와 사용자별 Redis 캐시에 저장된 정보를 바로 표시합니다. 목록에 들어가는 것만으로 에이전트 파드를 깨우거나 동기화를 기다리지 않습니다.
에이전트가 직접 만든 최신 스킬과 제안을 확인하려면 에이전트와 동기화를 누르세요. 이 작업은 잠든 에이전트를 깨울 수 있습니다. 동기화 중에도 저장된 목록을 볼 수 있으며, 아직 반영되지 않은 항목은 동기화 대기로 표시됩니다. 스킬을 생성·수정·삭제할 때의 동기화는 계속 자동으로 수행됩니다.