스킬과 자율 스킬 시스템

스킬은 에이전트에게 특정 작업을 수행하는 방법을 가르치는 패키지입니다. 업무 지침, 실행 코드, 참조 문서, 자산을 한 폴더에 묶어 재사용·공유할 수 있게 만듭니다.

2026-05부터는 스킬을 거의 신경 쓸 일이 없습니다. 에이전트가 자율적으로 적합한 스킬을 찾아 쓰고, 더 나은 스킬이 있으면 채팅에 1-click 설치 카드를 띄웁니다. 사용하다 결함을 발견하면 스스로 고치고, 라이브러리가 지저분해지면 정기적으로 정리 제안을 보내줍니다. 사용자는 중요한 결정 시점에만 확인하면 됩니다.

에이전트가 스킬을 쓰는 흐름

에이전트가 스킬을 활용할 때 일어나는 일은 세 단계로 정리됩니다.

탐색에서 찾기: 에이전트가 작업을 시작하면서 도움이 될 만한 스킬을 스킬 탭의 탐색에서 자동으로 찾습니다.
1-click 설치: 좋은 스킬을 찾으면 채팅창에 설치 카드를 띄웁니다. 버튼 한 번이면 해당 스킬이 이 에이전트에 추가됩니다.
바로 실행: 설치된 스킬은 다음 작업부터 곧바로 사용됩니다. 사용자가 별도로 실행 명령을 내릴 필요가 없습니다.

스케줄 실행에서는 탐색에서 새로 가져오기는 불가하고, 이미 설치된 스킬만 직접 호출할 수 있습니다.

한눈에 보기

궁금한 점	답
내가 스킬을 직접 설치해야 하나요?	아니오. 에이전트가 필요한 스킬을 찾아 채팅에 1-click 설치 카드를 띄웁니다. 버튼 한 번으로 끝납니다.
어떤 스킬을 쓸지 누가 정하나요?	에이전트가 작업 결과 메모·반복 패턴·실패 신호를 분석해 상위 3개를 자동 추천합니다.
스킬이 망가지면?	에이전트가 자기 복사본을 가진 스킬이면 직접 고치고, 아니면 작성자에게 개선 제안을 보냅니다.
라이브러리가 어지러워지면?	정기적으로 검사해 정리가 필요한 항목을 묶어 알림으로 보내줍니다(사용자당 최대 주 1회). 자동으로 삭제하거나 변경하지 않습니다.
Notion·GitHub 같은 외부 서비스는?	한 번만 연결해두면 스킬이 실행될 때 인증 정보가 자동으로 전달됩니다.
내 컴퓨터에 영향을 주나요?	스킬은 격리된 클라우드 환경에서만 실행되므로 내 컴퓨터에는 아무런 영향이 없습니다.

사용자가 만나는 7가지 순간

1. 채팅 중 스킬 제안 카드

에이전트가 작업 도중 “이 스킬을 설치하면 더 잘할 수 있다”고 판단하면 채팅창에 카드를 띄웁니다. 카드에는 추천 이유와 함께 설치 버튼이 있어, 한 번 눌러 바로 적용됩니다.

추천은 3단계 신호를 기반으로 이루어집니다.

최근 작업 결과에 남긴 메모 (무엇이 잘 됐고 무엇이 부족했는지)
반복 패턴 감지 (같은 도구를 계속 쓰고 있는 경우)
실패한 스킬 신호 (반복적으로 오류가 난 스킬이 있는 경우)

이 신호들을 종합해 추천 점수를 산출하고, 75점(0~100) 이상인 스킬만 카드에 나타납니다. 카드가 뜨지 않는다면 충분히 잘 해결되고 있다는 뜻입니다.

2. GitHub 저장소에서 직접 가져오기

에이전트가 추천해주는 스킬 말고도, 공개된 GitHub 저장소의 스킬을 직접 가져올 수 있습니다.

탐색 화면에서: 스킬 탭 → 탐색 상단의 GitHub에서 가져오기 버튼을 누르고 저장소 주소(owner/repo 또는 전체 URL)를 입력하면 바로 가져와집니다. 이렇게 가져온 스킬은 나만 볼 수 있는 비공개 스킬로 등록되며, 이후 원하는 에이전트에 설치해 쓸 수 있습니다.
채팅으로: 에이전트에게 “이 GitHub 저장소의 스킬을 설치해줘”처럼 링크와 함께 요청할 수도 있습니다. 이때는 에이전트가 먼저 저장소 내용을 확인해 보여주고, 사용자가 승인해야 실제로 설치가 진행됩니다.

가져올 저장소에는 스킬 설명 파일(SKILL.md)이 있어야 하며, 파일 개수와 용량에 제한이 있습니다. 저장소 안에 스킬이 여러 개 있으면 어떤 것을 가져올지 직접 선택합니다.

3. 외부 서비스 1회 연결

Notion, GitHub, Slack 같은 외부 서비스를 쓰는 스킬은 처음 한 번 로그인(OAuth 연결)이 필요합니다. 에이전트 설정의 연결 항목 또는 탐색의 스킬 카드에서 진행할 수 있습니다. 한 번 연결해두면 그 스킬이 실행될 때마다 인증 정보가 안전하게 자동으로 전달됩니다.

자세한 연결 방법은 외부 서비스 연결하기를 참고하세요.

4. 라이브러리 정리 카드

스킬 라이브러리는 정기적으로 점검됩니다(사용자당 최대 주 1회). 정리가 필요한 항목이 발견되면 알림을 보내고, 내 서재 탭 상단 배너를 눌러 열리는 정리 화면에서 항목별로 처리할 수 있습니다.

4가지 정리 항목:

항목	의미
오류 반복 (FAILING)	누적 실행 중 오류가 4회 이상 발생한 스킬
미사용 (UNUSED)	설치 후 30일 이상 한 번도 사용하지 않은 스킬
지원 종료 (DEPRECATED_ORIGIN)	원작자가 더 이상 지원하지 않는다고 표시한 스킬
기능 중복 (DUPLICATE_FUNCTION)	설치된 스킬 중 기능이 거의 같은 쌍

정리 제안은 “지울까요?”만 묻습니다. 새 버전이 나온 스킬과 보안상 회수된 버전은 정리 제안이 아니라 바로 아래 받은 업데이트에서 다룹니다 — 같은 스킬이 두 곳에 동시에 뜨면, 업데이트를 이미 처리했는데도 정리 제안이 남아 있는 것처럼 보이기 때문입니다.

정리 카드가 뜨더라도 아무것도 자동으로 삭제되지 않습니다. 항목마다 유지·삭제 중 원하는 행동을 직접 선택하며, 삭제는 되돌릴 수 없으므로 적용 전에 확인창이 한 번 더 뜹니다.

5. 받은 업데이트 — 위험 등급과 재동의

설치한 스킬의 원작자가 새 버전을 내놓으면 내 서재 → 받은 업데이트에 모여 보입니다. 각 업데이트에는 위험 등급 표시가 붙어, 그대로 반영해도 되는지 한 번 더 살펴봐야 하는지를 한눈에 알 수 있습니다.

업데이트 있음(초록, 정보성): 가벼운 변경입니다. 원하는 때 검토·반영하면 됩니다.
변경 확인(주황): 실행 코드가 바뀐 업데이트입니다. 내용을 확인한 뒤 반영을 권장합니다.
재동의 필요(빨강): 권한이나 동작이 크게 달라지는 업데이트입니다. 카드를 열면 무엇이 왜 바뀌었는지 구체적으로 안내되며, 내용을 확인하고 그래도 업데이트를 눌러야 실제로 적용됩니다. 확인 전에는 기존 버전이 그대로 유지되어, 모르는 사이에 위험한 변경이 들어오지 않습니다.

여러 스킬의 업데이트가 한꺼번에 쌓였다면 받은 업데이트 목록 상단의 적용 버튼으로 한 번에 반영할 수 있습니다. 일괄 적용 대상은 초록·주황 등급뿐이며, 재동의가 필요한 빨강 등급과 회수된 버전은 각각 따로 확인해야 하므로 대상에서 빠집니다. 항목을 직접 골라 담을 수도 있고, 아무것도 고르지 않으면 일괄 적용 가능한 전체가 대상이 됩니다.

각 업데이트 줄에는 무엇이 바뀌었는지 짧은 요약도 함께 나타납니다(예: “새 권한 1개 · 스크립트 2개 추가”). 다만 재동의가 필요한 업데이트에는 요약 대신 재동의 안내만 나타나는데, 위험을 사실 나열로 완화해 보이게 하지 않기 위해서입니다.

등급과 상관없이 업데이트 카드에서 변경사항 보기를 누르면 실제로 무엇이 달라지는지 파일별로 확인할 수 있습니다. 파일 목록은 평소 접혀 있다가 눌렀을 때만 펼쳐지고, 바뀐 줄이 추가(초록)·삭제(빨강)로 구분되어 나타납니다. 필요한 파일만 펼쳐 보면 되므로 업데이트가 여러 파일에 걸쳐 있어도 화면이 무거워지지 않고, 변경이 아주 큰 파일은 일부만 보여드립니다.

또한 어떤 버전이 악성으로 확정되어 회수되면, 그 버전을 설치해 둔 사용자에게 가장 먼저 보이는 우선 경고가 표시됩니다. 이동할 안전한 버전이 있으면 바로 업데이트하는 버튼이, 없으면 제거 버튼만 제공됩니다.

6. 내가 만든 스킬에 들어온 개선 제안 검토

스킬을 공개한 경우, 다른 사용자의 에이전트가 결함을 발견하면 자동으로 개선 제안(proposal)이 누적됩니다. 같은 결함을 여러 표현으로 보고해도 하나의 제안으로 묶입니다.

내 서재 → 개선 제안 페이지에서 각 제안을 검토하고 채택·기각할 수 있습니다.

채택(Accept): 제안을 “검토 완료”로 표시합니다. 이후 스킬 편집 화면에서 내용을 직접 수정해 새 버전으로 배포합니다.
기각(Reject): 사유(선택)를 남기고 제안을 닫습니다.

설치했지만 아직 손대지 않은 스킬의 결함은 위와 똑같이 원작자에게 개선 제안으로 전달됩니다. 반면 에이전트가 이미 자가 수정해서 나만의 전용 복사본이 된 스킬이라면, 그 이후의 결함은 에이전트가 그 자리에서 바로 고치고 버전 스냅샷만 남기며 원작자에게는 전달되지 않습니다.

스킬을 직접 만들고 제안을 관리하는 자세한 방법은 스킬 생성하기를 참고하세요.

7. 스킬 상세 화면 — 성장 타임라인, 계보 뷰, 이 스킬을 쓰는 내 에이전트

탐색의 스킬 카드에서는 Health 칩으로 이 스킬의 건강 상태를 확인할 수 있습니다. 최근 7일간 얼마나 자주 실행됐는지, 실행이 얼마나 잘 성공했는지, 최근에도 꾸준히 쓰이고 있는지를 종합해 0~~100점으로 나타낸 값이며, 초록(70 이상)·노랑(40~~69)·빨강(40 미만) 점으로 표시됩니다. 성공률이 높아도 실행 횟수가 적거나 오래 쓰이지 않았다면 점수가 낮게 나올 수 있습니다. 실행 데이터가 아직 없는 신규 스킬은 표시되지 않습니다. 다른 스킬에서 파생된 스킬이면 카드에 원본 작성자와 기여자 수도 함께 표시됩니다.

스킬 카드에는 최근 몇 주간의 사용 흐름을 보여주는 작은 막대 그래프도 함께 나타납니다(탐색·내 서재 공통, 웹·iOS·Android 동일). 가장 최근 주는 진한 색으로 강조되고, 사용 데이터가 아직 충분히 쌓이지 않은 스킬에는 표시되지 않습니다.

스킬 상세 화면으로 들어가면, 보는 사람에 따라 다른 내용이 나타납니다.

내가 만든 스킬이라면: 버전이 어떻게 늘어왔는지 보여주는 성장 타임라인이 나타납니다. 마디 색으로 에이전트가 스스로 고친 변경인지 내가 직접 편집한 변경인지 구분되고, 공개 중이면 현재 버전에 “공개 중” 표시가 붙습니다. 예전 버전 마디에서 바로 롤백할 수 있습니다.
내가 설치한 스킬이라면: 원본을 따라가는 계보 뷰가 나타납니다. 원본에 아직 반영하지 않은 새 버전은 대기 카드로 나타나고, 반영 절차는 위 받은 업데이트와 같은 위험 등급·재동의 규칙을 그대로 따릅니다. 스킬을 직접 고쳐서 쓰기 시작하면(내 사본이 만들어지면) 이 스킬은 내 서재 목록으로 옮겨가고, 거기서 카드를 열면 원본의 새 버전을 내 사본에 병합하는 화면이 나타납니다 — 내가 고친 파일 목록도 함께 확인할 수 있습니다. 내가 고친 부분과 원본 변경이 겹치면, 이 스킬을 쓰는 에이전트가 있는 경우 그 에이전트가 대화창에서 충돌 조정을 맡아 처리하고 결과를 알려드립니다.
어느 쪽이든: 상세 화면 아래에서 이 스킬을 실제로 장착하고 있는 내 에이전트 목록을 확인할 수 있습니다(본인 소유 에이전트만 표시되며, 다른 사용자의 에이전트는 보이지 않습니다).
에이전트 여러 개가 같은 스킬을 각자 다르게 고쳐 쓰면: 예를 들어 에이전트 A가 이 스킬을 자기 방식대로 고쳐 쓰기 시작했는데, 에이전트 B도 같은 스킬을 다른 방향으로 고쳐 쓰기 시작했다고 해봅시다(둘 다 내가 소유한 에이전트입니다). 내 서재 목록에는 사본마다 카드가 따로 뜨지 않고, 한 카드에 사본 개수가 적힌 작은 버튼(예: ×2)이 붙습니다. 카드나 버튼을 누르면 목록이 펼쳐지면서 어느 에이전트의 사본인지(“A의 사본”처럼)와 원본과 무엇이 달라졌는지 알려주는 짧은 변경 노트가 함께 나타납니다. 이 변경 노트는 미리 정해진 문구가 아니라, 에이전트가 그 자리에서 고치면서 “무엇이 문제였고 무엇을 바꿨는지”를 직접 남긴 설명입니다. 펼친 목록에서 원하는 사본을 다시 누르면 그 사본의 상세 화면으로 들어갑니다. 이 펼침 동작은 웹·iOS·Android 모두 똑같이 지원됩니다.

에이전트가 알아서 하는 일

다음은 사용자가 별도로 신경 쓰지 않아도 에이전트가 자율적으로 처리하는 부분입니다.

자동 추천: 작업 완료 후 에이전트가 경험을 돌아보며 쌓은 메모, 반복 패턴, 실패한 스킬 신호를 종합해 도움이 될 만한 스킬을 탐색합니다. 아직 설치하지 않았고, 건강 점수가 충분한 스킬 중 상위 후보를 골라 점수 기준(75점 이상)을 통과한 것만 카드로 제안합니다.

자가 패치: 내가 가져온 스킬에서 결함을 발견하면 에이전트가 직접 수정합니다. 정확히 한 곳만 바꾸고, 수정 후 스킬 구조 검증을 통과해야 저장됩니다. 검증에 실패하면 자동으로 이전 상태로 되돌아갑니다. 수정이 완료되면 버전 스냅샷이 생성되며, 스킬 상세 화면의 버전 기록에서 이전 버전으로 롤백할 수 있습니다(스킬 소유자 전용).

자율 생성: 작업을 마친 뒤 에이전트가 스스로 경험을 되짚어보다가 재사용 가능한 새로운 절차를 발견하면, 사용자 승인 없이 완전히 새로운 비공개 스킬을 만들어 자신에게 바로 장착합니다(휴지기 중 진행되는 ‘드림’ 사이클에서도 같은 방식으로 만들어질 수 있습니다). 이렇게 만들어진 스킬은 처음부터 나만 볼 수 있는 비공개 스킬이며, 생성이 끝나면 알림으로 알려드립니다. 이 자율 생성은 턴당 비용 한도와 에이전트당 쿨다운이 걸려 있어 자주 일어나지는 않습니다.

결함 보고 3방향 처리: 에이전트가 스킬 문제를 보고하면 자동으로 분류됩니다. 시스템 공식 스킬이면 운영팀 검토 큐로, 에이전트가 이미 자가 수정해 내 전용 복사본을 가진 스킬이면 에이전트가 직접 다시 수정하고, 그 외 스킬이면 작성자의 개선 제안에 누적됩니다. 같은 결함이 7일 이내에 여러 번 들어오면 하나의 제안으로 묶이고, 같은 사용자·스킬 조합에서는 하루 5건까지만 보고됩니다.

자동 정리와 게시 제안: 에이전트가 스스로 만든 스킬 중 오랫동안 쓰이지 않는 것은 자동으로 보관 처리되어 눈에 띄지 않게 정리됩니다. 삭제가 아니라 보관이므로 스킬 페이지에서 언제든 복원할 수 있고, 처리 후에는 알림으로 안내해 드립니다. 반대로 스스로 만든 스킬이 꾸준히 잘 쓰이고 있으면 게시해보라는 제안 알림이 옵니다 — 게시 여부는 항상 사용자의 선택입니다.

알림 9종

스킬 관련 알림은 9가지입니다.

알림	의미
개선 제안 도착 (SKILL_PROPOSAL_RECEIVED)	내가 만든 스킬에 새 개선 제안이 접수됨
라이브러리 정리 (SKILL_LIBRARY_CLEANUP_AVAILABLE)	정리가 필요한 스킬이 발견됨
스킬 지원 종료 (SKILL_DEPRECATED)	설치한 스킬이 지원 종료 처리됨
주간 건강 리포트 (SKILL_HEALTH_REPORT_WEEKLY)	내 스킬의 주간 성공률·사용 현황 요약
자동 보관	오랫동안 쓰이지 않은 자율 생성 스킬이 자동으로 보관됨
게시 제안	꾸준히 잘 쓰이고 있는 스킬을 게시해보라는 제안
버전 회수 경고 (SKILL_VERSION_REVOKED)	설치한 스킬의 버전이 악성으로 확정되어 회수됨 — 위 “받은 업데이트”의 회수 경고와 동일(즉시 발송)
자율 생성 완료 (SKILL_AUTO_CREATED)	에이전트가 작업 경험을 바탕으로 새 비공개 스킬을 스스로 만들어 장착함
자율 패치 완료 (SKILL_AUTO_PATCHED)	에이전트가 설치된 스킬의 결함을 스스로 고침

개선 제안 도착·라이브러리 정리·스킬 지원 종료·주간 건강 리포트는 알림 설정에서 개별로 켜고 끌 수 있습니다. 자동 보관·게시 제안·버전 회수 경고·자율 생성 완료·자율 패치 완료는 개별로 끌 수 없는 알림입니다.

더 적극적으로 활용하려면

에이전트가 잘 해낸 작업 흐름을 스킬로 직접 만들어 재사용하거나 공개하고 싶다면 스킬 생성하기를 참고하세요.

고급 (Advanced)

아래 내용은 일반 사용자에게 필요하지 않습니다. 스킬 내부 동작을 직접 들여다보거나 디버깅이 필요한 경우에만 참고하세요.

스킬 직접 만들기 — DRAFT 리뷰 모달

에이전트가 작업 흐름을 스킬로 패키징하면 먼저 임시 저장본(DRAFT)이 만들어지고, 화면에 리뷰 모달이 뜹니다. 내용을 확인한 뒤 ‘생성’을 누르면 스킬이 만들어지고(비공개 또는 공개 중 선택), ‘취소’를 누르면 임시 저장본이 즉시 삭제됩니다.

이 DRAFT 리뷰 모달은 에이전트가 그 자리에서 “이 작업 흐름을 스킬로 저장하자”고 명시적으로 판단해 패키징을 시도할 때의 경로입니다. 이와 별도로, 위 “에이전트가 알아서 하는 일 → 자율 생성”에서 설명한 것처럼 작업을 마친 뒤 돌아보며 재사용 가치가 있다고 판단한 절차는 검토 단계 없이 곧바로 비공개 스킬로 만들어져 에이전트에 장착되며, 사용자에게는 만들어진 뒤에 알림으로만 안내됩니다.

스킬 첫 설치 — 내용 미리 보기

에이전트가 스킬을 처음 설치하려 할 때, 실제 설치 전에 스킬 설명 전체와 포함된 파일 목록을 먼저 보여드립니다. 이 미리 보기를 확인한 뒤 에이전트가 다시 설치를 진행하며, 사용자 승인이 완료되어야 실제로 설치됩니다.

스킬 본문 lazy 로딩

스킬 파일은 시스템 지시에 항상 포함되지 않습니다. 에이전트가 스킬을 처음 실행할 때 상세 본문(README 전체 내용)을 받아오고, 이후 같은 대화 세그먼트 안에서 다시 호출하면 “이미 받았음”이라는 짧은 확인 응답만 돌아옵니다. 대화 이력이 정리(새 세그먼트 시작)되면 다음 실행 시 본문을 다시 받습니다. 시스템 지시에는 항상 frontmatter 요약(짧은 설명)만 남아 있으며, 전체 내용은 실행 시점의 결과 채널로만 전달됩니다.

변경 내용 미리보기 한도

업데이트·병합 화면의 변경 내용 미리보기는 파일당 표시 분량에 상한이 있습니다. 상한을 넘으면 일부만 보여드리고 잘렸다는 안내가 함께 나타납니다. 여러 파일이 한꺼번에 바뀐 경우 전체 응답에도 별도 상한이 있어, 이를 넘는 파일은 목록에는 나타나지만 내용 미리보기는 생략됩니다. 변경 내용 본문은 패널을 여는 것만으로 자동으로 받아오지 않고, 변경사항 보기를 눌렀을 때만 서버에서 가져옵니다(지연 로딩). 그 안에서 개별 파일을 펼치고 접는 것은 이미 받아온 내용을 보여주거나 감추는 것뿐입니다.

일괄 적용은 한 번에 최대 50건까지 처리됩니다. 그보다 많은 항목을 골랐다면 넘는 항목은 인박스에 그대로 남아 다음 실행 때 다시 적용할 수 있습니다.

변경 노트는 누가 쓰나

사본 목록·업데이트 인박스·버전 이력에 나오는 변경 노트는 시스템이 자동으로 만드는 문구가 아니라, 에이전트가 스킬을 고칠 때마다 반드시 함께 남겨야 하는 짧은 설명입니다. 이 값은 다른 사용자에게 공개되는 마켓 리스팅에도 그대로 실릴 수 있어, 노출 전에 시크릿 검사를 거칩니다. 검사에 걸리면 노트만 빠지고 수정 자체는 정상 저장됩니다.

설치 슬롯: 원본 참조 vs. 내가 가져온 복사본

스킬을 처음 설치하면 원본을 직접 참조하는 방식(원본 참조)으로 등록됩니다. 이후 에이전트가 해당 스킬을 자가 패치하면 내 전용 복사본이 만들어지고, 에이전트는 이 복사본 슬롯을 사용합니다. 이 전환은 자동으로 이루어지며 사용자가 별도로 조작할 필요가 없습니다.

GitHub 저장소에서 가져온 스킬은 원본을 참조하지 않고 처음부터 나만의 비공개 스킬로 등록됩니다(마켓플레이스 스킬을 설치할 때의 “원본 참조”와 다릅니다). 저장소 소유자가 나중에 코드를 바꿔도 자동으로 반영되지 않으며, 최신 내용이 필요하면 같은 주소로 다시 가져와야 합니다.

UpServe 스킬은 AgentSkills 표준에 호환되므로 Claude Code·Cursor·Goose 등과 zip으로 교환할 수 있습니다. 표준 사양·디렉토리 레이아웃·시크릿 주입 등 세부는 스킬 생성하기 → 고급을 참고하세요.