스킬, 도구, 통합 페이지

Operations 섹션에는 “내 에이전트가 무엇을 할 수 있으며, 어떻게 확장할 수 있는가?”라는 질문에 답하는 세 가지 대시보드 라우트가 있습니다. Skills 페이지(/skills)는 유일하게 편집이 가능한 페이지로, 스킬 번들을 직접 생성하거나 ClawHub 마켓플레이스 및 GitHub에서 설치할 수 있습니다. Tools 페이지(/tools)와 Integrations 페이지(/integrations)는 읽기 전용 참조 페이지입니다. Tools는 런타임이 발견한 모든 호출 가능한 도구와 CLI 바이너리를 나열하고, Integrations는 채널 및 커넥터의 상태 카탈로그를 보여줍니다.

새로운 기능을 추가하려면 Skills 페이지를, 특정 도구나 바이너리가 에이전트에서 실제로 사용 가능한지 확인하려면 Tools 페이지를, 어떤 통합이 연결되어 있고 어떤 것을 구성할 수 있는지 확인하려면 Integrations 페이지를 사용하세요. 세 페이지 모두 대시보드의 베어러 토큰 인증을 통해 접근합니다. 브라우저 연결 방법은 대시보드 실행하기를 참조하세요.

Skills 페이지 (/skills)

스킬은 재사용 가능한 지침/기능 번들로, Markdown 지침과 선택적 도구 정의로 구성됩니다. Kumiho 메모리의 항목과 디스크의 ~/.revka/workspace/skills/ 디렉터리에 저장됩니다. Skills 페이지는 해당 번들의 레지스트리 관리자이며, 외부에서 스킬을 가져오기 위한 두 가지 추가 패널(ClawHub 마켓플레이스, GitHub URL 설치기)을 제공합니다.

페이지는 3열 레이아웃으로 구성됩니다.

• 왼쪽 — 레지스트리 상태 표시줄(전체 / 활성 / 사용 중단 / 도메인 수)과 로컬 스킬의 검색 가능한 목록. 이름, 설명, 도메인, 태그로 검색할 수 있습니다.
• 가운데 — 선택한 스킬의 작업 공간: 도메인, 리비전 번호, 생성 날짜, 태그, 설명, 그리고 Markdown으로 렌더링된 스킬 content. 여기서 편집, 사용 중단/재활성화, 삭제를 수행할 수 있습니다.
• 오른쪽 — GitHub 설치기와 ClawHub 마켓플레이스 패널.

로컬 스킬 관리

스킬은 게이트웨이의 skills API로 관리되는 CRUD 엔티티입니다. 모든 쓰기 작업은 새 리비전을 생성합니다.

작업	Method + path	인증
스킬 목록 조회	GET /api/skills?include_deprecated=true&page=1&per_page=100	Bearer
스킬 상세 조회 (content 포함)	GET /api/skills/{kref}	Bearer
스킬 생성	POST /api/skills	Bearer
스킬 수정 (새 리비전)	PUT /api/skills/{kref}	Bearer
사용 중단 / 재활성화	POST /api/skills/deprecate	Bearer
삭제	DELETE /api/skills/{kref}	Bearer

생성/편집 모달에는 다섯 가지 필드가 있습니다. name, description, content는 필수 항목이며, domain의 기본값은 Other입니다. tags는 쉼표로 구분된 목록으로, 저장 시 분리 및 공백 제거가 적용됩니다.

필드	타입	의미
name	string	스킬 이름 (필수)
description	string	목록에 표시되는 짧은 설명 (필수)
content	string	Markdown 본문 — 스킬의 지침/프롬프트 (필수)
domain	enum	Memory, Creative, Privacy, Graph, Behavioral, Other 중 하나
tags	string[]	검색을 위한 쉼표 구분 키워드

스킬을 생성하면 폼이 레지스트리에 직접 전송됩니다.

POST /api/skills
Authorization: Bearer rk_<token>
Content-Type: application/json

{
  "name": "release-notes",
  "description": "Draft release notes from a changelog",
  "content": "# Release notes\nSummarise the changelog into...",
  "domain": "Creative",
  "tags": ["writing", "release"]
}

게이트웨이는 content를 ~/.revka/workspace/skills/<slug>.md를 가리키는 SKILL.md 아티팩트로 저장하며, 설명, 도메인, 태그는 리비전 메타데이터에 보관합니다. URL 경로에서 사용하는 kref는 kref:// 이후의 부분입니다. 예를 들어 CognitiveMemory/Skills/my-skill.skill과 같은 형태입니다.

참고

content 필드는 뷰어에서 Markdown(GitHub Flavored)으로 렌더링되므로 제목, 목록, 코드 펜스를 사용할 수 있습니다. 스킬을 사용 중단하면 삭제 없이 에이전트에서 숨겨지며, 삭제는 영구적입니다. 레지스트리는 서버 측에서 약 30초간 캐시되며, 모든 쓰기 작업 시 캐시가 무효화되므로 변경 사항이 즉시 반영됩니다.

ClawHub 패널

ClawHub는 커뮤니티 스킬 마켓플레이스입니다. 오른쪽 패널은 처음 열릴 때 trending 스킬을 불러옵니다. trending 결과가 없으면 agent 검색으로 대체됩니다. 쿼리를 입력하고 Enter를 누르거나(또는 Search 클릭) 마켓플레이스를 검색할 수 있으며, 쿼리가 한 글자를 초과하면 검색이 실행됩니다. Trending을 클릭하면 쿼리가 초기화되고 trending 목록으로 돌아갑니다. 각 결과 카드에는 이름, 설명과 함께 Install 버튼이 표시됩니다.

작업	Method + path	인증
마켓플레이스 검색	GET /api/clawhub/search?q=<query>&limit=12	Bearer
Trending 스킬	GET /api/clawhub/trending?limit=12	Bearer
스킬 상세 조회	GET /api/clawhub/skills/{slug}	Bearer
스킬 설치	POST /api/clawhub/install/{slug}	Bearer

설치 시 스킬의 SKILL.md를 가져와 ~/.revka/workspace/skills/<slug>.md에 저장하고, Kumiho 메모리 프로젝트의 Skills 스페이스에 skill 항목으로 등록(리비전에 published 태그 지정)한 뒤, 로컬 인덱스를 새로 고쳐 왼쪽에 즉시 표시합니다.

POST /api/clawhub/install/rust-debugging
Authorization: Bearer rk_<token>

{ "installed": true, "name": "rust-debugging", "slug": "rust-debugging" }

주의

ClawHub 통합이 비활성화된 경우 라우트는 {"error":"ClawHub integration disabled"}와 함께 400을 반환하고, 마켓플레이스에 접근할 수 없는 경우 502를 반환합니다. 익명 탐색과 설치는 토큰 없이도 가능하며, clh_… API 토큰은 게시 시에만 필요합니다. config.toml의 [clawhub] 섹션에서 통합을 구성하세요(enabled, api_url, 선택적 api_token). 자세한 내용은 비용, 감사, ClawHub & 자격증명 API를 참조하세요.

GitHub 설치기

GitHub 패널을 사용하면 저장소 URL에서 직접 스킬을 설치할 수 있습니다. 동일한 설치 엔드포인트를 재사용하며, 슬러그 위치에 붙여넣은 URL이 전달됩니다.

POST /api/clawhub/install/{github-url}
Authorization: Bearer rk_<token>

1. 설치기 필드에 GitHub URL을 붙여넣습니다.
2. Enter를 누르거나 Install을 클릭합니다.
3. 성공하면 스킬이 로컬 Kumiho Skills 스페이스에 등록되고 인덱스가 새로 고쳐집니다. ClawHub 설치와 동일하게 동작합니다.

스킬 파일 형식(SKILL.md 프런트매터 및 SKILL.toml), 디스크 레이아웃, shell/HTTP 도구 종류, open_skills 커뮤니티 라이브러리에 대한 자세한 내용은 스킬 시스템 레퍼런스와 revka 스킬, 워크플로 & SOP를 참조하세요.

Tools 페이지 (/tools)

Tools 페이지는 에이전트가 현재 호출할 수 있는 모든 것의 읽기 전용 참조입니다. 도구는 런타임에 내장 도구, 구성된 통합, 연결된 MCP 서버, 발견된 바이너리로부터 등록되므로, 이 페이지는 라이브 레지스트리를 반영하며 여기서 직접 편집할 수는 없습니다. 단일 검색창으로 두 섹션을 동시에 필터링할 수 있으며, Reload 버튼으로 데이터를 다시 가져올 수 있습니다. 페이지는 두 개의 접을 수 있는 섹션으로 구성됩니다.

두 개의 엔드포인트에서 데이터를 가져옵니다.

섹션	Method + path	인증	표시 내용
에이전트 도구	GET /api/tools	Bearer	도구 이름, 설명, 입력 스키마 파라미터
CLI 도구	GET /api/cli-tools	Bearer	바이너리 이름, 경로, 버전, 카테고리

에이전트 도구 vs CLI 도구

이 두 목록은 서로 다른 질문에 답하며, “에이전트가 X를 왜 못하는가?”를 디버깅할 때 그 차이가 중요합니다.

• 에이전트 도구는 모델이 에이전트 루프 내에서 호출하는 구조화된 도구, 즉 MCP 스타일의 도구 인터페이스입니다. 각 도구는 이름과 설명이 있는 카드로 표시되며, 카드를 클릭하면 전체 JSON 파라미터 스키마가 펼쳐집니다. LLM이 직접 호출할 수 있는 도구 집합으로, 내장 도구(shell, file_read, web_search_tool, …), 자격증명 기반 통합 도구(notion, jira, google_workspace, …), 그리고 외부 MCP 서버에서 프록시된 도구(<server>__<tool> 접두사)를 포함합니다.
• CLI 도구는 에이전트가 shell 도구를 통해 실행할 수 있는 호스트의 외부 바이너리입니다. 표에는 각 바이너리의 이름, 파일시스템 경로, 감지된 버전, 카테고리 태그가 나열됩니다. 바이너리가 여기에 표시된다는 것은 런타임이 PATH에서 해당 바이너리를 발견했음을 의미하며, 새로운 모델 호출 가능 도구가 추가되는 것은 아닙니다. 에이전트는 shell을 통해 해당 바이너리에 접근합니다.

요약하면, 에이전트 도구는 모델이 이름과 타입이 지정된 인수로 직접 호출하는 것이고, CLI 도구는 모델이 셸 명령으로 실행할 수 있는 디스크상의 프로그램입니다. 에이전트 도구 목록에서 특정 기능이 없다면, 대개 통합의 자격증명이 설정되지 않았거나 MCP 서버가 연결되지 않은 것이며, 이 페이지에서 수정할 수 있는 사항이 아닙니다.

참고

에이전트 도구 레지스트리에는 기본 도구(항상 활성화, 자격증명 불필요), 확장 도구(일치하는 자격증명이 있을 때 등록), 그리고 런타임 핸들이 필요한 런타임 인식 도구(cron, delegate, SOP, sessions, …)가 있습니다. 전체 레지스트리, 지연 로딩, tool_search 메커니즘에 대한 자세한 내용은 외부 MCP 서버 연결과 도구 개요를 참조하세요.

Integrations 페이지 (/integrations)

Integrations 페이지는 Revka가 지원하는 모든 통합(채팅 채널, AI 모델 프로바이더, 생산성 커넥터 등)과 각 상태 배지를 보여주는 읽기 전용 카탈로그입니다. 정보 제공 목적의 페이지로, 무엇이 연결되어 있고 무엇을 구성할 수 있는지 확인할 수 있지만, 여기서 직접 활성화하지는 않습니다.

하나의 엔드포인트를 사용합니다.

GET /api/integrations
Authorization: Bearer rk_<token>

레이아웃은 왼쪽 패널(커버리지 수 + 카테고리 필터), 가운데 통합 카드 그리드, 오른쪽 선택된 카드의 상세 패널로 구성됩니다. 카테고리를 클릭하면 필터링되고, 카드를 클릭하면 설명, 카테고리, 상태, 운영 준비 여부를 확인할 수 있습니다. 카테고리는 카탈로그 자체에서 파생되며 Chat, AI Model, Productivity, Music & Audio, Smart Home, Tools & Automation, Media & Creative, Social, Platform을 포함합니다.

상태 배지

모든 통합은 다음 세 가지 상태 중 하나를 가집니다.

상태	배지	의미
Active	Active	현재 구성되어 실행 중 (예: 항상 켜져 있는 Shell, File System, Weather, 또는 활성화한 채널)
Available	Available	지원되며 구성 가능 — 아직 활성화되지 않음
ComingSoon	Coming soon	카탈로그에 등록되었지만 아직 사용 불가

Available에서 Active로

이 페이지에서는 통합을 활성화하지 않으며, 활성화는 구성에서 이루어집니다. 통합을 Available에서 Active로 전환하려면 다음 단계를 따르세요.

1. 이 페이지에서 통합 이름과 카테고리를 확인합니다.
2. Config 페이지(/config)를 열고 config.toml에 해당 섹션을 추가하거나 활성화합니다. 예를 들어 채팅 채널은 [channels_config] 항목, 생산성 커넥터는 [notion]/[jira]/[google_workspace] 블록, AI 모델은 프로바이더 블록을 추가합니다.
3. 필요한 자격증명(config 키 또는 환경 변수)을 입력하고 저장합니다.
4. Integrations 페이지를 새로 고치면 런타임에 등록된 후 상태가 Active로 변경됩니다.

참고

채널 구성은 메시징 채널 연결과 채널 개요에서 설명합니다. 생산성 커넥터(Notion, Jira, Composio, Google Workspace, Microsoft 365, LinkedIn)와 전체 상태 카탈로그는 통합 카탈로그와 Config: 채널, 도구 & 통합에서 자세히 설명합니다.

관련 페이지

스킬 시스템 SKILL.md / SKILL.toml 형식, shell & HTTP 도구 종류, open_skills 라이브러리.

통합 카탈로그 카테고리별 전체 상태 카탈로그와 각 통합에 필요한 항목.

도구 개요 완전한 에이전트 도구 레지스트리 — 내장 도구, 통합, MCP 도구.

Cron, 비용 & Config 페이지 대시보드에서 config.toml을 편집하고 채널 및 커넥터를 활성화합니다.