Skills와 Rules

최종 수정: 2026년 6월 22일

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

실행하면 연결할 환경(IDE)과 Personal Access Token을 차례로 묻고, MCP 연결과 함께 Skills·Rules를 해당 환경에 설치합니다. MCP 연결 과정과 환경별 설정은 MCP에서 다룹니다.

@latest를 쓰면 항상 최신 버전이 설치됩니다. WEEGLOO API와 권장 패턴은 계속 업데이트되므로, 이 명령을 주기적으로 다시 실행해 Skills와 Rules를 최신 상태로 유지하는 것이 좋습니다.

직접 살펴보기

Skills와 Rules는 공개 저장소에 들어 있습니다. 설치된 내용을 직접 열어 보거나, 어떤 작업에 어떤 안내가 있는지 확인하려면 저장소를 참고하면 됩니다.

Skills와 Rules는 저장소의 plugins/weegloo/ 아래에 각각 skills/와 rules/ 디렉토리로 들어 있습니다.

설치 도구를 쓰지 않고 직접 연동할 때도 위 latest 경로의 파일을 그대로 가져다 쓰면 됩니다.

다음으로 할 일

  • MCP: MCP 연결 방법과 환경별 설정을 다룹니다. Skills·Rules도 이 연결 과정에서 함께 설치합니다.