Claude Skills·Agent Skills·Cursor Rules 차이는? 2026 대조 가이드

1. Claude Skills, Agent Skills, Cursor Rules가 왜 자주 섞일까?

2025년 하반기부터 2026년까지 AI 코딩 도구들이 일제히 「버전 관리 가능한 Agent 설정」을 내놓았습니다. Cursor는 .cursor/rules와 .cursor/skills를 강화하고, Anthropic은 Claude Code에서 .claude/skills를 밀고, 커뮤니티는 agentskills.io를 크로스 호스트 표준으로 정리했습니다. 세 흐름이 거의 동시에 겹치고 마케팅에도 Skill·Agent가 반복되면서 한국어권에서도 번역이 제각각이라 전형적인 혼란이 생깁니다:

• 30단계 릴리스 절차를 Cursor Rules에 넣어 매 대화마다 수천 token을 짊어짐;
• Claude Code에서 「Rules 패널」을 찾지만 제품명은 Skills;
• 공유받은 SKILL.md를 .cursor와 .claude 중 어디에 둘지 모름;
• 「Agent Skills」를 새 SaaS로 오해하지만 실은 파일 형식 규격임.

근본 원인은 제품층·구현층·표준층의 명명이 겹친 것입니다. 이미 AI Coding Workflow, Rules, Skills 완전 해설을 읽었다면 그 글을 「워크플로 아키텍처」, 본 글을 「명사 대조표 + 의사결정 핸드북」으로 보시면 됩니다. 두 글은 보완 관계이며 중복을 피했습니다.

개인 개발자는 「일단 AGENTS.md에 다 쓴다」는 경향이 있고, 팀은 「Rules와 Skills 경계가 모호해 리뷰가 안 된다」는 다른 고통을 겪습니다. 전자는 컨텍스트 비대, 후자는 거버넌스 부재——둘 다 층 배치 오류에서 비롯됩니다. 본문 비교표는 PR에서 「이건 Rule인가 Skill인가」를 논의하는 공통 언어가 됩니다.

2. 각각의 정의 (What)

2.1 Cursor Rules — 항상 로드되는 제약층

Cursor Rules는 Cursor IDE의 상주 정책입니다. 프로젝트를 열고 glob에 맞으면 자동으로 컨텍스트에 주입됩니다. 일반적인 위치는 .cursor/rules/*.mdc, 사용자 Settings의 Rules, 루트 AGENTS.md. 최소 diff, 건드리면 안 되는 디렉터리, 응답 언어, 테스트 실행 조건, force push 금지 등 짧고 단단하며 매 대화에 성립하는 조항에 적합합니다. 공식 문서도 Rules는 간결하게——긴 Runbook은 여기에 넣지 말라고 강조합니다.

2.2 Claude Skills — Claude Code의 온디맨드 Runbook 제품

Claude Skills(Claude Code Skills)는 Anthropic 터미널/IDE Agent 제품 내부의 능력 패키지입니다. .claude/skills/<name>/SKILL.md(사용자 수준도 가능). Agent는 frontmatter의 description을 먼저 읽고 의도가 맞으면 본문을 로드해 code review, 릴리스, 보안 감사 등 다단계 절차를 실행합니다. /skill-name 명시 호출과 disable-model-invocation으로 오작동 방지도 지원합니다. 심층 선정은 Claude Code Skills 10 프레임워크 가이드를 참고하세요.

2.3 Agent Skills — 크로스툴 SKILL.md 오픈 표준

Agent Skills는 특정 벤더의 기능 스위치가 아니라 Agent Skills Specification이 정의한 파일 형식과 디렉터리 관례입니다. SKILL.md frontmatter(name, description 등) + 본문 Runbook + 선택적 references/, 스크립트. Cursor, Claude Code 등 호스트가 같은 규약으로 파싱하므로 팀은 동일 Skill 본문을 .cursor/skills와 .claude/skills에 동기화하고 각 도구 문서에 맞게 frontmatter만 조정하면 됩니다. 표준이 푸는 것은 이식성이며 Cursor Rules의 상주 제약을 대체하지 않습니다.

3. 핵심 비교표 (How Compare)

3.1 경로와 소유권 대조

4. 시나리오별 선택 — 의사결정 매트릭스

5. 권장 조합 (Stack)

조합 A — Cursor 단독(개인 프로젝트)

• Rules: core.mdc에 레드라인 3개(최소 diff, 임의 commit 금지, 변경 후 lint)
• Skills: code-review 하나(Agent Skills 형식, .cursor/skills/)
• Claude 디렉터리는 만들지 않아 저장소 노이즈 방지

조합 B — Claude Code 단독(터미널 우선)

• Claude Skills: commit, security-review(disable-model-invocation: true)
• 프로젝트 루트 CLAUDE.md가 「상주 제약」 역할(Rules 유사, Agent Skills 아님)

조합 C — 듀얼 스택 팀(권장)

• 단일 skills/ 소스 또는 submodule을 CI로 .cursor/skills와 .claude/skills에 동기화
• Cursor Rules는 Cursor 개발자용; Claude 사용자는 CLAUDE.md 참고
• 새 Skill은 먼저 Agent Skills frontmatter로 작성 후 도구별 미세 조정

조합 D — 원격 실행 Agent

• Skill에 SSH로 클라우드 Mac에서 xcodebuild 실행 단계 명시
• Rules로 미확인 프로덕션 설정 변경 금지
• 실행 노드는 고정 macOS 이미지——AI 코딩 도구 선정의 「실행 환경」 축과 일치

6. 흔한 오해

• 「Agent Skills는 Claude 전용」 → 오픈 형식; Claude Skills는 Anthropic 구현 중 하나.
• 「Cursor Rules에 20단계 릴리스 가능」 → Skill로 분리; Rules가 길수록 매 대화 컨텍스트 낭비.
• 「SKILL.md를 Rules 폴더에 복사하면 됨」 → 확장자·로더 다름; .mdc Rules는 Skill description 매칭 안 함.
• 「셋은 배타적, 하나만 선택」 → 전형은 Rules(제약) + Skills(절차) + Agent Skills 형식(공유).
• 「Skills 있으면 Rules 불필요」 → Skills는 온디맨드; 「매번 force push 금지」 류 바닥선은 대체 불가.
• 「표준 업데이트 시 Claude Skills 자동 호환」 → agentskills.io와 각 호스트 changelog 추적; frontmatter 필드 분화 가능.

7. 7단계 도입: 복사 가능한 예제

1. 목록화: 매 대화 지킬 제약 → Cursor Rules 후보; 가끔 도는 절차 → Skills 후보.
2. Rules 작성: 파일당 80줄 미만, globs로 범위 제한.
3. Agent Skills 규격으로 SKILL.md 초안: name + 동사로 시작하는 description.
4. 호스트 디렉터리 배치: Cursor는 .cursor/skills/<name>/SKILL.md; Claude Code는 .claude/skills/.
5. 고위험 Skill: disable-model-invocation: true로 /security-review 등 명시 호출만.
6. Git 커밋: 코드와 같은 PR로, 개인 노트북에만 두지 않기.
7. macOS 노드 연결: Skill에 Xcode/shell 포함 시 Runbook에 SSH 대상·사전 점검 명시.

# .cursor/rules/core.mdc
---
description: Core repo constraints (always on)
globs: "**/*"
---
- Minimize diff; no drive-by refactors.
- Never commit unless the user explicitly asks.
- Do not modify backend/ unless the task requires it.

# .cursor/skills/code-review/SKILL.md  (Claude: .claude/skills/code-review/SKILL.md)
---
name: code-review
description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR.
---
1. Run `git diff --staged` (or branch vs main).
2. Report Critical / Warning / Suggestion.
3. Do not auto-fix unless asked.

---
name: xcode-release
description: Archive and export IPA on macOS runner. Manual invocation only.
disable-model-invocation: true
---
Prerequisites: macOS host, valid signing cert, Xcode selected.
Steps: clean → archive → export → verify IPA checksum.

8. 요약

Cursor Rules는 「Cursor에서 매 대화 넘으면 안 되는 선」, Claude Skills는 「Claude Code에서 특정 작업을 SOP대로」, Agent Skills는 「그 SOP 파일의 형태와 도구 간 운반」. 셋은 대체 관계가 아니라 제약층 + 제품 기능 + 형식 표준의 조합입니다. 먼저 층으로 분류한 뒤 남의 설정을 복사하면 「파일 넣었는데 안 뜸」 우회를 줄일 수 있습니다.

관련 링크: Cursor Rules · Claude Code Skills · Agent Skills 오픈 표준 · 사이트 Workflow / Rules / Skills 3층 엔지니어링