Harness Engineering - Cursor: Skill.md / Rules로 작업 가이드 붙이기

---

1. 개념 비교

Claude의 Skill과 가장 비슷한 쪽은 Cursor의 Agent Skill이고, “이 프로젝트에서는 무조건 이렇게”에 가까운 건 Rules입니다.

---

2. Skill 저장 위치 (중요)

공식 가이드(create-skill) 기준:

~/.cursor/skills-cursor/ 는 Cursor 내장 스킬용이라, 여기에 새 스킬을 만들지 말 것이라고 안내합니다.

디렉터리 구조 예:

my-skill/
├── SKILL.md          # 필수
├── reference.md      # 선택: 상세 문서
├── examples.md       # 선택: 예시
└── scripts/          # 선택: 스크립트

---

3. 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로 빼는 점진적 공개 패턴.

---

4. Project Rule (.cursor/rules/*.mdc)

---
description: 이 규칙이 하는 일 한 줄
globs: "**/*.tsx"
alwaysApply: false
---

# 규칙 제목
본문…

• alwaysApply: true: 대화마다 항상 비슷한 우선순위로 걸리게 하고 싶을 때.
• globs: 해당 패턴 파일을 다룰 때만 적용.

가이드상 한 규칙은 짧게(대략 50줄 이하 권장), 주제별로 파일을 나누는 것이 좋습니다.

---

5. Claude Skill과의 대응

• Claude 프로젝트/Skill에 길게 적어 두는 것 ≈ Cursor에서는 Skill + 필요 시 Rule으로 나누는 편이 맞습니다.
• “항상 이 레포 스타일” → Rule
• “이 작업 할 때만 이 절차” → Skill

---

6. 확인용 체크리스트 (스킬 마무리 전)

• description에 무엇을 하고, 어떤 말/상황일 때 쓸지 적었는지
• 3인칭·구체적 트리거
• SKILL.md가 너무 길지 않은지 (길면 reference.md로 분리)
• 개인/프로젝트 경로를 ~/.cursor/skills/ / .cursor/skills/ 로 잡았는지 (skills-cursor 아님)

---

https://cursor.com/docs/skills

https://code.claude.com/docs/ko/skills#claude-skills