스킬

스킬은 특정 워크플로 수행 방법을 Anyy에 가르치는 재사용 지침 패키지입니다. SKILL.md, 지원 파일, 호환 채팅 인터페이스에 나타나는 명령을 포함할 수 있습니다.

스킬 출처

Dashboard는 출처별로 스킬을 나눕니다.

출처	의미
System	Anyy에 번들됨. 보이지만 사용자가 전환·제거 불가
User Installed	선택 프로필의 관리 스킬 루트에 설치됨
Agent Created	에이전트 지원 워크플로가 기존 스킬 레코드를 만들었을 때 표시되는 관리 출처 라벨

스킬은 프로필 범위입니다. 다른 프로필에는 자체 카탈로그와 활성 상태가 있습니다.

Dashboard에서 설치하거나 대화에서 지정 출처 설치를 요청할 수 있습니다. 해당 대화에 skill_manage가 있으면 선택 프로필의 관리 라이브러리에 기록합니다. Dashboard와 CLI도 같은 라이브러리를 사용합니다.

대화로 설치

Anyy 호스트에서 접근 가능한 신뢰하는 로컬 .zip 패키지 경로를 주고 설치를 요청하세요. 설치 후 Dashboard → Skills를 갱신하여 출처, 활성 상태, 내용을 확인하세요.

반대 방향도 가능합니다. Dashboard에서 설치한 뒤 같은 프로필의 Anyy에 사용을 요청하세요. 다음 프롬프트는 다시 로드된 카탈로그를 발견하고 설치된 SKILL.md를 읽을 수 있습니다. 이미 실행 중인 프롬프트는 수용된 컨텍스트를 유지합니다. 페이지에 없거나 대화에서 읽지 못하면 성공 메시지만으로 충분하지 않습니다.

스킬 확인

Dashboard → Skills에서 스킬을 선택해 다음을 검토합니다.

• ID, 이름, 설명, 범위.
• 출처 분류와 관리 상태.
• 활성 또는 비활성 상태.
• 렌더링된 SKILL.md 콘텐츠.
• 파일 경로.
• 연결된 지원 파일.

타사 스킬 활성화·설치 전에 지침을 읽으세요. 스킬은 Anyy에 실행을 요청하는 내용과 선택 도구에 영향을 줄 수 있습니다.

활성화와 비활성화

시스템 스킬이 아닌 스킬의 토글을 사용하세요. 비활성화는 파일을 삭제하지 않고 일반 해석에서 제외합니다. 다시 사용하려면 활성화하세요.

외부에서 파일을 바꾸면 카탈로그를 다시 로드하세요. 다음 프롬프트는 갱신 카탈로그를 쓰며 이미 수용된 프롬프트는 지침을 유지합니다. 활성 상태는 별도로 확인하세요. 비활성 스킬 교체가 활성화를 의미하지는 않습니다.

Dashboard에서 설치

Install Skill을 선택하고 정확히 스킬 하나를 담은 로컬 .zip을 업로드하세요. 최상위 SKILL.md와 지원 파일 또는 단일 스킬 디렉터리 형식입니다.

멀티파트 오버헤드를 포함한 전체 업로드 요청은 10 MiB 이하여야 합니다. ZIP과 압축 해제 콘텐츠도 각각 10 MiB 제한입니다. 검증은 경로 탐색, 심볼릭 링크, 특수 파일, 준비 루트 밖 항목을 거부합니다. SKILL.md 이름은 release-notes처럼 단일 하이픈으로 연결한 소문자/숫자 최대 64자여야 하며 경로일 수 없습니다. 둘러싸는 디렉터리가 있으면 같은 이름을 사용하세요. 같은 이름의 기존 관리 스킬을 대체합니다.

상주 스킬 서비스는 선택 프로필의 업로드 ID, SHA-256, 만료를 확인하고 패키지를 적용해 카탈로그를 다시 로드합니다. 설치는 로컬 ZIP만 받습니다. GitHub 출처, 원격 URL, 로컬 디렉터리, 모음 설치는 미지원이며 기존 스킬의 과거 출처 메타데이터는 유지됩니다.

스킬은 코드 수준의 신뢰로 취급하세요

설치 전 패키지 지침, 요청 명령, 외부 다운로드, 참조 파일을 검토하세요. 아카이브 검증은 패키지 구조를 확인하며 지침을 신뢰할지 결정하는 책임은 사용자에게 있습니다.

스킬 제거

상세 페이지에서 Remove Skill을 선택하면 선택 프로필의 관리 스킬을 제거하고 카탈로그를 다시 로드합니다. 시스템 스킬은 Dashboard에서 제거할 수 없습니다.

CLI 관리

CLI는 Anyy 호스트가 접근할 수 있는 로컬 ZIP을 설치합니다. Dashboard와 같은 관리 라이브러리 및 아카이브 검증을 사용합니다.

anyy skills list
anyy skills view weather
anyy skills install ./weather.zip
anyy skills uninstall weather
anyy skills rollback weather
anyy skills reload

유용한 옵션:

• --force는 기존 관리 스킬을 교체합니다.
• --now는 오프라인 변경 후 Gateway 다시 로드를 요청합니다. 상주 RPC 변경은 이미 카탈로그를 다시 로드합니다.
• --revision ID는 특정 불변 리비전으로 롤백합니다.
• --json은 기계 판독 출력을 반환합니다.

--revision이 없으면 이전 관리 리비전으로 롤백합니다. 상주 Anyy 런타임이 프로필을 소유하지 않을 때만 오프라인 변경이 허용됩니다. 실행 Gateway가 없으면 다음 시작 때 파일을 발견합니다. 대화 변경도 보통 다시 로드합니다. skill_manage가 reload:false를 쓰거나 reload_error를 보고하면 다음 카탈로그에 의존하기 전에 다시 로드하세요.

스킬 사용

TUI에서 /skills, Dashboard 채팅에서 /로 실시간 카탈로그를 탐색하세요. 설치 스킬은 표준 명령을 추가할 수 있습니다. 정확한 목록은 선택 프로필, 인터페이스, 플랫폼, 활성 상태에 따릅니다.

문제 해결

문제	해결
설치 실패	출처 또는 업로드 오류와 선택 프로필 확인
채팅에 스킬이 없음	같은 프로필·활성 상태와 다시 로드 오류 확인 후 사용 가능한 read 또는 bash 리더로 새 프롬프트 제출
ZIP 거부	스킬 이름·단일 스킬 구조 확인, 심볼릭 링크/경로 이탈 제거, 10 MiB 안에 멀티파트 여유 확보
제거·롤백 차단	상주 절차 사용 또는 오프라인 변경 전에 Anyy 중지
시스템 스킬 토글 불가	시스템 스킬은 Anyy 릴리스가 관리

기능 구성은 도구에서 관리하세요. 스킬 자체는 도구나 권한을 부여하지 않습니다.