Kimi Code에서 스킬 사용하기

Kimi Code는 개발자를 위해 설계된 AI 프로그래밍 어시스턴트로, 터미널이나 에디터에서 바로 실행되어 코드 작성, 버그 수정, 문서 생성을 도와줍니다. Kimi Code는 SKILL.md 파일을 통해 지식 기반 지침을 제공할 수 있습니다. AI가 이 파일을 읽으면 그 안에 정의된 표준을 따릅니다. 코드 스타일, 워크플로, 모범 사례를 정의하는 데 적합합니다.

스킬 호출하기

Kimi Code CLI에서는 슬래시 명령으로 스킬을 호출할 수 있습니다:

Bash

예를 들어 /skill:git-commits를 입력하면 Kimi Code가 해당 SKILL.md 내용을 읽고 이를 지침으로 에이전트에 전달합니다.

슬래시 명령 뒤에 추가 설명을 붙일 수도 있습니다. 이 설명은 스킬 지침의 끝에 추가됩니다:

Bash

일반적인 대화에서는 수동으로 호출할 필요가 없습니다. 에이전트가 맥락을 바탕으로 스킬 내용을 읽을지 자동으로 판단합니다.

첫 번째 스킬 만들기

스킬 만들기는 두 단계면 충분합니다. 스킬 디렉터리에 하위 디렉터리를 만들고, 그 안에 SKILL.md 파일을 생성하세요.

권장 저장 위치(모든 프로젝트에 적용):

Text

SKILL.md는 YAML Frontmatter로 메타데이터를 정의한 뒤, 핵심 규칙은 Markdown으로 작성합니다:

Markdown

Frontmatter의 name과 description은 모두 선택 필드입니다. 생략하면 디렉터리 이름이 기본값으로 사용됩니다.

예시

팀에서 커밋 메시지에 Conventional Commits 형식을 요구하지만, 매번 설명하기는 번거롭습니다. 이를 스킬로 작성해 두면 앞으로는 명령 하나로 불러올 수 있습니다.

1단계: 스킬 파일 만들기

Markdown

2단계: 코드 변경을 마친 뒤 스킬 호출하기

Bash

Kimi Code는 여러분의 표준과 작업 설명을 함께 읽고, 형식 요구사항을 다시 설명하지 않아도 올바른 형식의 커밋 메시지를 바로 출력합니다.

Flow 스킬: 여러 단계 워크플로 정의하기

일반 스킬이 정적인 표준을 제공한다면, Flow 스킬은 여러 단계로 이루어진 프로세스를 자동화하도록 정의할 수 있습니다.

Frontmatter에 type: flow를 설정하고 Mermaid 또는 D2 형식의 플로차트를 포함하면 Flow 스킬을 만들 수 있습니다.

Markdown

실행할 때는 /flow:<name> 명령을 사용하세요. 에이전트는 BEGIN 노드에서 시작해 END에 도달할 때까지 각 단계를 순서대로 자동 수행합니다.

스킬 로딩 방식

Kimi Code CLI는 다음 우선순위에 따라 스킬을 검색하고 로드합니다(먼저 일치한 항목이 우선합니다):

1. 내장 스킬: 소프트웨어 패키지와 함께 설치되며 기본 기능을 제공합니다.
2. 사용자 수준 스킬: 홈 디렉터리에 저장되어 모든 프로젝트에 적용됩니다.
3. 프로젝트 수준 스킬: 프로젝트 디렉터리에 저장되어 해당 프로젝트에만 적용됩니다.

--skills-dir 매개변수로 스킬 디렉터리를 추가로 직접 지정할 수도 있습니다:

Bash

전체 구성 옵션과 매개변수 설명은 Kimi Code CLI 스킬 문서를 참고하세요.