스킬과 자율 스킬 시스템

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

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

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

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

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

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

한눈에 보기

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

1. 채팅 중 스킬 제안 카드

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

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

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

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

2. 외부 서비스 1회 연결

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

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

3. 라이브러리 정리 카드

스킬 라이브러리는 정기적으로 점검됩니다(사용자당 최대 주 1회). 정리가 필요한 항목이 발견되면 알림을 보내고, 설정 → 스킬 정리 페이지(/settings/library-cleanup)에서 항목별로 처리할 수 있습니다.

5가지 정리 항목:

정리 카드가 뜨더라도 아무것도 자동으로 삭제되거나 변경되지 않습니다. 항목마다 유지·업데이트·삭제 중 원하는 행동을 직접 선택합니다.

4. 내 스킬에 들어온 개선 제안 검토

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

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

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

내가 마켓플레이스에서 가져온 스킬의 결함은 별도 흐름으로 처리됩니다. 에이전트가 직접 수정하고 버전 스냅샷을 남기며, 이 내역은 작성자에게 전달되지 않습니다.

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

5. 스킬 카드의 Health 칩과 계보 배지

마켓플레이스 스킬 카드에서 두 가지 신뢰 신호를 확인할 수 있습니다.

• Health 칩: 스킬의 7일 평균 성공률을 초록(70 이상)·노랑(40~69)·빨강(40 미만) 점으로 표시합니다. 실행 데이터가 아직 없는 신규 스킬은 표시되지 않습니다.
• 계보 배지: 다른 스킬에서 파생된 스킬에 표시됩니다. 원본 스킬이 누구 것인지, 얼마나 많은 기여자가 있는지를 보여주는 읽기 전용 정보입니다.

에이전트가 알아서 하는 일

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

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

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

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

알림 4종

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

알림을 켜거나 끄려면 알림 설정에서 조정할 수 있습니다.

더 적극적으로 활용하려면

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

고급 (Advanced)

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

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

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

마켓플레이스 스킬 첫 설치 — 내용 미리 보기

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

스킬 본문 lazy 로딩

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

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

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

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