스킬 시스템

스킬(Skill)은 Agent가 사용하는 기능 패키지입니다. SKILL.md를 핵심으로 하는 디렉터리로, 조작 설명과 스크립트, 참고 자료가 담겨 있습니다. Agent는 작업을 수행할 때 이 내용을 필요에 따라 읽어들여, 원래는 할 수 없던 일을 처리합니다. 예를 들어 목차와 머리글이 포함된 Word 문서를 생성할 수 있습니다.

스킬이란

각 스킬은 하나의 디렉터리이며 최소한 SKILL.md 한 개를 포함합니다. frontmatter에는 name과 description을 작성하고, 본문은 Agent를 위한 조작 설명입니다. 디렉터리에는 첨부 파일(스크립트, 참고 문서, 설정 템플릿)을 함께 담고 의존성과 MCP 서버를 선언할 수도 있습니다.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

스킬은 점진적 공개 방식을 사용합니다. Agent는 평소에 각 스킬의 이름과 설명만 확인하고, 현재 작업에 특정 스킬이 필요하다고 판단하면 그때 전체 본문과 첨부 파일을 읽어들입니다. 이렇게 하면 많은 스킬을 설치해도 모든 내용을 매 대화마다 넣지 않습니다.

시스템 스킬과 사용자 설치 스킬

플랫폼에 사전 설치되는 범용 시스템 스킬은 크게 두 가지입니다. Office 문서 생성(docx / xlsx / pptx / pdf)과 개발 관련 스킬(프런트엔드, 풀스택, iOS, Android, Flutter, React Native 등)입니다. 콘솔의 '스킬 관리' 페이지에서 전체 목록을 확인할 수 있고, 어떤 스킬이든 열어 버전, 첨부 파일, SKILL.md 전문을 볼 수 있습니다.

Office 문서 생성

이 시스템 스킬 그룹은 Agent 단계가 Markdown 텍스트뿐 아니라 오피스 문서 파일을 직접 산출하도록 합니다:

대표적인 사용 예: 일일 보고 워크플로의 Agent 단계에서 xlsx 스킬로 서식이 적용된 주간 보고 표를 산출하여 실행 산출물과 함께 다운로드하거나 Slack / 이메일로 바로 전달합니다. 산출물은 공개 링크로 게시할 수도 있습니다. 다음을 참고하세요:제품 공개 공유.

스킬 마켓: 설치와 버전

콘솔의 'ClawHub 스킬 마켓' 페이지는 ClawHub 레지스트리에 연결됩니다. 키워드로 검색하여 각 스킬의 버전, 작성자, 다운로드 수, 업데이트 시간을 확인하고 설치를 누르면 자신의 계정에 설치됩니다.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• 스킬에는 버전 번호가 있습니다. 설치된 스킬은 '스킬 관리' 페이지에서 '업데이트 확인'을 누르면 업그레이드 시 최신 버전을 다시 다운로드합니다
• 마켓에서 설치한 스킬만 업그레이드 절차를 거칩니다. ZIP으로 가져온 스킬은 업그레이드 출처가 없으므로 다시 한 번 가져오면 됩니다
• 제거는 자신의 계정에 설치된 것만 해제하며, 같은 스킬을 설치한 다른 사용자에게는 영향을 주지 않습니다
• 직접 작성한 스킬을 ZIP으로 업로드하여 가져올 수도 있습니다. 패키지에는 SKILL.md 한 개가 반드시 있어야 하고 name과 description 필드가 유효해야 하며, 압축 해제 후 전체 크기가 100MB를 넘지 않아야 합니다

사용자별 활성화 / 비활성화

'스킬 관리' 페이지에서 각 스킬에는 개별 스위치가 있습니다. 활성화 / 비활성화 상태는 자신의 계정에 기록됩니다. 특정 시스템 스킬을 비활성화하면 자신의 Agent에게 더 이상 보이지 않으며 다른 사용자에게는 영향이 없습니다. 다른 사용자가 개인적으로 설치한 스킬은 볼 수도 없고 로드되지도 않습니다.

Agent 범위: 특정 Agent가 사용할 수 있는 스킬 제한

계정 수준 스위치 외에도 Agent 설정에서 개별 Agent에 더 작은 스킬 범위를 지정할 수 있습니다. 자주 쓰는 필드:

• Skills 하위 시스템 스위치 — 끄면 이 Agent는 스킬을 전혀 사용하지 않습니다
• 화이트리스트 모드 — 켜면 화이트리스트에 있는 스킬만 이 Agent가 탐지할 수 있으며, 내장 스킬은 자동으로 화이트리스트에 추가됩니다
• 비활성화 목록 — 블랙리스트로, 화이트리스트 모드가 꺼진 상태에서도 적용됩니다
• 요청당 최대 스킬 수 — 단일 요청에 주입되는 스킬 수를 제한합니다
• 자동 검색 다운로드 — 기본값은 꺼짐입니다. 켜면 Agent가 로컬에 기능이 없다고 판단할 때 자동으로 ClawHub에서 검색하여 새 스킬을 다운로드합니다. 외부 다운로드 동작이 발생하므로 기업 환경에서는 신중하게 사용하세요

실행 시 플랫폼은 Agent 설정과 사용자 수준 상태를 병합하여 최종 적용되는 스킬 범위를 결정합니다. '스킬 관리' 페이지에서 비활성화한 스킬은 이번 실행의 모든 Agent에서 사용할 수 없습니다.

런타임 설정

일부 스킬은 서드파티 서비스의 API token처럼 먼저 매개변수나 자격 증명을 입력해야 동작합니다. 설정 템플릿이 있는 스킬은 카드에 '설정됨 / 설정 필요'가 표시되며, '스킬 설정'을 눌러 필드별로 입력하면 됩니다.

• 민감 필드(token, 비밀번호, 개인 키 등)는 저장 후 마스킹되어 표시되며 평문을 다시 보여주지 않습니다. 마스킹된 상태로 제출하면 기존 값을 그대로 사용합니다
• 직접 설치한 스킬은 본인이 설정할 수 있습니다. 시스템 스킬의 런타임 설정은 관리자만 수정할 수 있습니다

자주 쓰는 엔드포인트

관련 페이지

• Agent 구성에 대한 자세한 설명
• 내장 모듈 라이브러리
• 제품 공개 공유