Skills와 Rules
LLM 에이전트에 MCP를 연결하면 에이전트가 WEEGLOO API를 직접 호출할 수 있습니다. 그런데 API를 호출할 수 있다는 것과, 그 API를 WEEGLOO가 의도한 방식대로 정확히 쓰는 것은 다릅니다. 예를 들어 어떤 상황에 CMA를 쓰고 어떤 상황에 CDA를 써야 하는지, Content Type의 필드를 어떻게 설계해야 하는지, Delivery Access Token에 어떤 권한을 묶어야 안전한지는 호출 방법만으로는 알 수 없습니다.
Skills와 Rules는 이 간극을 메우는 두 가지 안내입니다. Skills는 특정 작업을 잘 수행하는 방법을 담은 가이드이고, Rules는 작업 전반에서 지켜야 할 규칙입니다. 설치 도구(npx weegloo@latest)가 MCP 연결과 함께 이 둘을 같이 설치할 수 있습니다.
Skills와 Rules의 차이
둘은 에이전트에게 주는 정보라는 점은 같지만, 역할이 다릅니다.
Skills는 특정 작업을 어떻게 수행하는지 단계와 패턴으로 정리한 가이드입니다. 작업마다 하나씩 있으며, 에이전트는 그 작업을 시작할 때 해당 Skill을 읽고 따릅니다. 예를 들어 Content Type 설계, 서비스 구조 선택, Delivery Access Token 발급 같은 작업에 각각 Skill이 있습니다. 에이전트는 추측 대신 검증된 방법을 따르게 됩니다.
Rules는 작업 종류와 무관하게 항상 지켜야 할 규칙입니다. 예를 들어 WEEGLOO API의 기본 주소, 리소스 목록을 페이지 단위로 가져오는 방식, 리소스를 수정할 때 버전 정보를 함께 보내야 한다는 점 같은 것입니다. 에이전트는 작업 내내 이 규칙을 배경으로 적용합니다.
정리하면 Skills는 "이 작업은 이렇게 한다"는 작업별 안내이고, Rules는 "어떤 작업을 하든 이건 지킨다"는 공통 규칙입니다.
설치하기
Skills와 Rules는 MCP 설치 도구가 함께 설치합니다. 터미널에서 다음을 실행하면 됩니다.
npx weegloo@latest실행하면 연결할 환경(에이전트)과 Personal Access Token을 차례로 묻고, MCP 서버와 함께 Skills·Rules를 해당 환경에 설치합니다. 설치 과정과 환경별 설정은 연결하기에서 다룹니다.
@latest를 쓰면 항상 최신 버전이 설치됩니다. 이미 설치한 뒤에 최신 상태로 맞추는 방법은 최신 상태로 유지하기에서 다룹니다.
최신 상태로 유지하기
Skills와 Rules는 한 번 설치하고 끝나는 것이 아닙니다. WEEGLOO에 새 기능이 생기고 권장 방식이 바뀔 때마다 이 안내도 함께 갱신됩니다. 반면 내 컴퓨터에 설치된 것은 설치하던 시점의 사본이라 그 자리에 머물러 있습니다.
설치본이 오래되면 두 가지가 벌어집니다. 새로 추가된 Skill과 Rule은 설치본에 아예 없으므로, 에이전트는 그 기능을 다루는 방법을 알지 못합니다. 이미 있던 항목의 내용이 바뀌었다면 에이전트는 지난 안내를 그대로 따릅니다. 어느 쪽이든 에이전트는 지금의 WEEGLOO가 아니라 설치하던 시점의 WEEGLOO를 기준으로 작업합니다. 에이전트가 내놓는 결과의 품질이 여기에서 갈리므로, Skills와 Rules는 최신 상태로 두는 것이 좋습니다.
최신으로 유지할 대상은 내 컴퓨터에 설치된 Skills와 Rules입니다. MCP 서버는 따로 갱신할 것이 없습니다.
새 버전이 나오면 에이전트가 알려 줍니다. 에이전트는 WEEGLOO 관련 작업을 시작할 때 설치된 버전을 확인하고, 최신이면 아무것도 표시하지 않습니다. 갱신할 것이 있을 때만 다음과 같은 안내와 함께 실행할 명령을 표시합니다.
이 업데이트는 자동으로 실행되지 않습니다. 설치된 파일을 다시 쓰는 작업이라 사용자가 확인한 뒤에 실행합니다. 안내가 표시되면 미루지 말고 그 자리에서 명령을 실행하는 것이 좋습니다. 안내에 표시된 명령을 그대로 터미널에 실행하면 됩니다.
--agent와 --location 자리에는 설치할 때 고른 환경과 위치가 들어가므로, 명령은 설치 상태에 따라 달라집니다. 안내에 표시된 명령을 그대로 쓰면 맞는 값이 들어갑니다.
명령을 직접 입력하는 대신 에이전트에게 "weegloo 업데이트 해줘"라고 말해도 됩니다. 에이전트는 실행할 명령을 이미 알고 있으므로, 어떤 명령을 써야 하는지 찾지 않아도 됩니다.
업데이트가 유지하는 것과 바꾸는 것
업데이트는 설치를 처음부터 다시 하는 것이 아닙니다. 처음 설치할 때 고른 선택을 유지한 채 내용만 최신으로 맞춥니다.
- 설치할 때 고른 Skills와 Rules의 선택이 그대로 유지됩니다. 일부만 설치했다면 그 상태로 남습니다.
- 지난 설치 이후에 새로 추가된 Skills와 Rules는 자동으로 함께 설치됩니다. 설치할 때 일부러 제외한 항목은 계속 제외된 상태로 남습니다.
- 저장소에서 삭제된 항목은 내 컴퓨터에서도 제거됩니다.
- 설치할 때 고른 버전에 그대로 머무릅니다.
- MCP 서버 설정은 건드리지 않습니다. 그래서 업데이트할 때는 Personal Access Token이 필요하지 않습니다.
설치된 Skill이나 Rule 파일을 손으로 지웠다면 업데이트가 그 파일을 다시 설치합니다. 항목을 빼려면 파일을 지우지 말고 설치 명령을 다시 실행해 선택 화면에서 해제합니다.
업데이트한 내용은 새 대화부터 적용됩니다. 에이전트는 대화를 시작할 때 Skills와 Rules를 읽어 두므로, 진행 중인 대화는 이전 내용을 계속 씁니다.
직접 살펴보기
Skills와 Rules는 공개 저장소에 들어 있습니다. 설치된 내용을 직접 열어 보거나, 어떤 작업에 어떤 안내가 있는지 확인하려면 저장소를 참고하면 됩니다.
Skills와 Rules는 저장소의 plugins/weegloo/ 아래에 각각 skills/와 rules/ 디렉토리로 들어 있습니다.
- Skills 디렉토리: plugins/weegloo/skills
- Rules 디렉토리: plugins/weegloo/rules
설치 도구를 쓰지 않고 직접 연동할 때도 위 latest 경로의 파일을 그대로 가져다 쓰면 됩니다.