스킬은 반복적인 워크플로를 재사용 가능한 구조화된 기능으로 바꿔 개발자가 AI와 협업하는 방식을 새롭게 정의합니다. 대표적인 AI 코드 편집기인 Cursor는 스킬을 적용하기에 가장 선호되는 도구이지만, 설정하려면 파일 구조, 맥락 관리, 프롬프트 설계를 이해해야 합니다. 이 가이드에서는 Cursor 스킬을 만들고 구성하는 방법, 유용한 예시, 그리고 AI로 사용자 정의 스킬을 구축해 모범 사례를 재사용 가능한 "몸에 밴 습관"으로 만드는 법을 살펴봅니다.
Cursor에서 스킬을 만들고 사용하는 방법은?
Cursor 스킬을 실전에서 활용하려면 먼저 프로젝트 구조 안에서 스킬을 설정하는 방법을 이해해야 합니다. 설정이 끝나면 스킬을 손쉽게 만들고 정리하며 사용해 개발 워크플로를 자동화할 수 있습니다. 다음 단계를 따라 Cursor에서 스킬을 만들고 사용해 보세요.
1단계: .cursor 폴더 만들기
먼저 프로젝트 루트 디렉터리로 이동해 .cursor라는 이름의 폴더를 만듭니다. 이 폴더에는 Cursor 전용 구성 파일과 프로젝트 수준 설정이 저장됩니다.
2단계: skills 디렉터리 추가하기
다음으로 .cursor 안에 skills 폴더를 만듭니다. 이 디렉터리에는 사용자 정의 스킬이 모두 담깁니다.
3단계: 스킬마다 폴더 만들기
각 스킬은 skills 디렉터리 안에 자체 폴더를 두어야 합니다. 예를 들면 다음과 같습니다:
api-creation-skilldocumentation-creatorcode-review-assistant
스킬을 폴더별로 분리하면 충돌을 막을 수 있고, 스킬 라이브러리가 커질수록 업데이트도 한결 수월해집니다
4단계: SKILL.md 파일 추가하기
각 스킬 폴더 안에 SKILL.``md라는 이름의 파일을 만듭니다. 이 파일은 스킬이 어떻게 작동하고 Cursor가 언제 적용해야 하는지 정의하는 표준 형식입니다.
5단계: 핵심 구조 정의하기
파일을 만들었다면 스킬을 설명하는 필수 섹션을 추가합니다.
일반적인 SKILL.md 파일에는 다음 항목이 포함되어야 합니다:
제목: 스킬의 이름입니다.
설명: 스킬을 언제 사용해야 하는지 알려줍니다.
지침: Cursor가 작업을 수행할 때 따르는 단계별 안내입니다.
구조가 명확할수록 Cursor가 스킬의 목적을 잘 이해하고 더 일관된 결과를 만들어 냅니다.
6단계: 선택적 보강 요소 추가하기 (필요한 경우)
기본 항목을 정의한 뒤에는 다음과 같은 섹션을 추가해 스킬을 한층 강화할 수 있습니다:
템플릿
예시
참고 사항
검증 규칙
출력 요구 사항
7단계: Cursor에서 스킬 사용하기
스킬 설정이 끝나면 Ctrl + I로 Cursor Chat을 엽니다. /를 입력해 사용 가능한 스킬 목록을 확인하고, 원하는 스킬을 선택한 뒤 작업을 설명하면 됩니다. Cursor는 선택한 스킬의 지침을 자동으로 불러와 작업에 적용합니다.
8단계: Cursor가 워크플로를 실행하도록 둡니다
AI는 설정한 스킬 규칙을 따르고, 필요하면 확인 질문을 던지며, API나 문서 같은 구조화된 결과물을 생성합니다.
사용자 정의 스킬은 개발자가 Cursor를 활용하는 방식을 크게 향상시킵니다. 자주 쓰는 프롬프트를 재사용 가능한 워크플로로 바꾸면 팀은 시간을 절약하고 일관성을 유지하며 복잡한 개발 작업을 간소화할 수 있습니다.
| 스킬 | 용도 |
|---|---|
| canvas | .canvas.tsx 파일을 생성/편집하고, 채팅 옆에 시각적 Canvas를 열어 차트, 표, 분석 패널 등을 표시합니다 |
| sdk | Cursor SDK (@cursor/sdk/ cursor-sdk)를 사용해 스크립트, CI, 자동화에서 Agent를 호출합니다 |
| babysit | PR의 병합 가능 상태 유지: 코멘트 처리, 충돌 해결, CI 수정 |
| statusline | CLI 사용자 정의 상태 표시줄 구성 (~/.cursor/cli-config.json의 statusLine) |
| split-to-prs | 현재 변경 사항을 검토하기 쉬운 여러 개의 작은 PR로 분할합니다 |
| update-cursor-settings | IDE 설정 수정 (settings.json: 테마, 글꼴, 서식 등) |
| update-cli-config | CLI 구성 수정 (~/.cursor/cli-config.json: 권한, 승인 모드, vim 등) |
| shell | /shell 명령을 처리하고, 뒤따르는 텍스트를 셸 명령 그대로 실행합니다 |
| migrate-to-skills | .cursor/rules/.mdc와 .cursor/commands/.md를 Skills 형식으로 이전합니다 |
| create-subagent | 사용자 정의 서브에이전트 (전용 AI 하위 에이전트)를 생성합니다 |
| create-rule | Cursor Rules (.cursor/rules/, AGENTS.md 등)를 생성합니다 |
| create-hook | Cursor Hooks (hooks.json, Agent 이벤트 전후에 사용자 정의 로직 실행)를 생성합니다 |
| create-skill | 새 Agent Skill (SKILL.md 구조와 사양 작성)을 생성합니다 |
Cursor에서 작동하는 외부 스킬
보너스 팁: Kimi로 나만의 스킬 손쉽게 만들기
Kimi의 문서-스킬 변환 기능을 활용하면 기존 문서, 코드, 템플릿을 재사용 가능한 AI 스킬로 바꿀 수 있습니다. 파일을 단순히 읽거나 요약하는 데 그치지 않고, 콘텐츠에서 구조화된 워크플로를 곧바로 추출해 자동화된 동작으로 전환합니다. 덕분에 Office 파일이나 내부 문서에 담긴 프로세스를 손쉽게 재사용하고, 워크플로를 처음부터 다시 만들 필요 없이 반복 작업을 자동화할 수 있습니다.
문서를 스킬로 변환하는 방법은?
이미 SOP, 템플릿, 보고서, 구조화된 파일이 있다면 Kimi에서 바로 스킬로 변환할 수 있습니다. 방법은 다음과 같습니다.
1단계: 문서-스킬 변환 도구에 접속하기
kimi.com에 접속해 시작합니다. "+"(만들기) 버튼을 클릭한 뒤 "Skills"로 이동해 "Document to skills" 옵션을 선택합니다.
2단계: Office 파일 업로드하기
Word 문서, PDF, Excel 시트, 프레젠테이션 같은 기존 파일을 업로드합니다. 업로드한 뒤에는 Kimi가 무엇을 추출하거나 복제하거나 재사용 가능한 스킬로 변환했으면 하는지 명확히 설명하세요. 그러면 Kimi가 파일을 처리하고 핵심 패턴을 인식해 문서 속 워크플로 구조를 자동으로 추출합니다.
3단계: 스킬 만들고 사용하기
"Create skill"을 클릭해 생성을 시작합니다. Kimi가 문서를 분석해 구조화되고 재사용 가능한 스킬로 변환하며, 파일 크기와 복잡도에 따라 몇 분이 걸릴 수 있습니다.
완료되면 스킬을 열어 바로 사용할 수 있습니다. 또한 스킬을 수정하거나 내용을 복사하거나, 재사용 또는 공유를 위해 .md 파일로 다운로드할 수도 있습니다.
Kimi 문서-스킬 변환 도구의 핵심 기능
문서를 재사용 가능한 스킬로 바꾸는 방법을 이해했다면, 이제 이 기능을 강력하게 만드는 요소를 살펴볼 차례입니다.
문서를 재사용 가능한 스킬 & 지식 체계로 전환
Kimi는 SOP, 매뉴얼, 가이드라인 같은 문서를 구조화된 스킬로 변환합니다. 이러한 스킬은 워크플로, 규칙, 도메인 지식을 재사용 가능한 형태로 담아냅니다. 정적인 파일이 아니라 실행 가능한 AI 지침이 되는 것이죠. 덕분에 같은 전문성을 여러 작업에 걸쳐 재사용할 수 있습니다.
사용자 정의 스킬과 기존 스킬을 결합해 더 나은 결과 얻기
Kimi에서는 직접 만든 사용자 정의 스킬과 내장 스킬을 함께 사용할 수 있습니다. 하나의 워크플로 안에서 서로 다른 스킬을 조합하면 기대치와 작업 요구에 더 부합하는 결과물을 만들 수 있습니다. 이러한 유연한 방식 덕분에 다양한 상황에 스킬을 손쉽게 맞추고 전반적인 출력 품질을 높일 수 있습니다.
맺음말
스킬은 지침을 재사용 가능한 워크플로로 편집기 안에 담아 개발 작업을 한결 수월하게 관리하도록 돕습니다. 덕분에 출력의 일관성을 유지하고 코딩 중 반복적인 수동 프롬프트 입력을 줄일 수 있습니다. 개발자는 같은 구조화된 로직을 서로 다른 프로젝트에 적용해 효율성과 체계성을 높일 수 있습니다. 설정을 더욱 빠르게 하고 싶다면 Kimi 같은 도구로 기존 문서를 재사용 가능한 스킬로 변환해 워크플로 자동화를 더 쉽고 확장성 있게 만들 수 있습니다.