| 구분 | 역할 | 언제 쓰면 좋은지 |
|---|---|---|
Agent Skill (SKILL.md) |
특정 워크플로·도구 사용 순서·팀 절차를 단계별로 적어 두는 것 | “PR 리뷰할 때 이 체크리스트”, “MCP 호출 전 스키마 읽기”처럼 작업 단위가 뚜렷할 때 |
Project Rule (.mdc) |
레포에서 항상 또는 특정 파일 패턴에 맞춰 지켜야 할 규칙 | 코딩 스타일, 폴더 구조, API 규칙 등 상시 컨텍스트 |
Claude의 Skill과 가장 비슷한 쪽은 Cursor의 Agent Skill이고, “이 프로젝트에서는 무조건 이렇게”에 가까운 건 Rules입니다.
공식 가이드(create-skill) 기준:
| 종류 | 경로 | 범위 |
|---|---|---|
| 개인 | ~/.cursor/skills/스킬이름/ |
내가 쓰는 모든 프로젝트 |
| 프로젝트 | .cursor/skills/스킬이름/ |
이 레포를 클론한 사람과 공유 |
~/.cursor/skills-cursor/ 는 Cursor 내장 스킬용이라, 여기에 새 스킬을 만들지 말 것이라고 안내합니다.
디렉터리 구조 예:
my-skill/
├── SKILL.md # 필수
├── reference.md # 선택: 상세 문서
├── examples.md # 선택: 예시
└── scripts/ # 선택: 스크립트
SKILL.md 최소 형식YAML 프론트매터 + 본문:
---
name: your-skill-name
description: 무엇을 하는지, 언제 쓸지(트리거 키워드 포함). 서술은 3인칭·구체적으로.
disable-model-invocation: true
---
# 스킬 제목
## 지시
에이전트가 따라야 할 단계·규칙.
name: 소문자·숫자·하이픈, 최대 64자.description: 매우 중요 — 에이전트가 “이 스킬을 켤지” 판단할 때 씁니다. WHAT + WHEN, 트리거 단어 포함, 3인칭 권장.disable-model-invocation: true (기본 권장): 이름으로 명시할 때만 로드. 생략하면 맥락에서 자동 호출될 수 있음.작성 팁: 본문은 짧게(권장 500줄 이하), 긴 내용은 reference.md로 빼는 점진적 공개 패턴.