Skills vs CLAUDE.md, AGENTS.md, Cursor 규칙

짧은 답변

CLAUDE.md, AGENTS.md, Cursor 규칙은 모든 세션에서 컨텍스트에 들어가므로 사실 정보와 경계만 담으세요. Skill은 해당 작업이 나올 때만 로드되므로, 모든 채팅을 무겁게 하지 않으면서 긴 절차를 담을 수 있습니다.

CLAUDE.md, AGENTS.md, Cursor 규칙은 누가 읽나요

Claude Code는 CLAUDE.md를, Codex는 AGENTS.md를 읽고, Cursor는 자체 규칙과 함께 두 파일을 모두 읽습니다. 셋 다 SKILL.md를 읽지만, 필요할 때만 읽습니다.

파일	읽는 에이전트	시점
`CLAUDE.md`	Claude Code, Cursor	Claude Code: 세션 시작 시 `~/.claude/CLAUDE.md`와 프로젝트에서 읽고, 하위 폴더의 파일은 Claude가 그 폴더에서 작업할 때 읽음. Cursor: 항상 적용.
`AGENTS.md`	Codex, Cursor	Codex: `~/.codex/AGENTS.md`를 먼저 읽고, 저장소 루트부터 시작한 폴더까지 폴더마다 파일 하나씩 읽음. 가장 가까운 파일이 우선하며 합계 32 KiB. Cursor: 항상 적용.
`.cursor/rules/*.mdc`	Cursor	네 가지 모드 중 하나: Always Apply, Apply Intelligently, Apply to Specific Files, Apply Manually
`SKILL.md`	세 에이전트 모두	요청이 일치하거나 이름으로 호출할 때만

쉬운 기준이 있습니다. 한 줄에 들어가고 모든 채팅에서 지켜져야 한다면 지침입니다. 설명하는 데 한 페이지가 필요하고 특정 작업에만 중요하다면 Skill입니다.

모든 세션

지침 파일은 사용 여부와 상관없이 모든 채팅에서 컨텍스트를 차지합니다

필요할 때

Skill은 사용되기 전까지 한 문장 정도만 차지합니다

흔한 전후 사례

CLAUDE.md에 릴리스 노트 작성법에 관한 60줄짜리 섹션이 조금씩 자라납니다. 디버깅 세션을 포함한 모든 채팅이 그 비용을 치르죠. 이를 Skill로 옮기면 한 줄만 남고, 절차는 릴리스 노트를 요청할 때만 로드됩니다.

CLAUDE.md, 옮긴 후

- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.

1
절차를 잘라 .claude/skills/release-notes/SKILL.md(Codex와 Cursor는 .agents/skills/)로 옮기세요.
2
언제 사용하는지 알려 주는 description을 작성하세요.
3
지침 파일에는 한 줄짜리 안내만 남기세요.
다음이 보여야 합니다: 더 짧아진 지침 파일, 그리고 릴리스 노트를 요청할 때만 로드되는 절차.

Cursor에서는 /migrate-to-skills가 “Apply Intelligently” 규칙을 Skills로 변환해 줍니다.

Claude Code가 모든 세션을 시작할 때 읽는 지침 Markdown 파일입니다. 개인 파일은 ~/.claude/CLAUDE.md에, 프로젝트 파일은 CLAUDE.md 또는 .claude/CLAUDE.md에 있습니다.

둘 다 쓰세요. 항상 참인 짧은 규칙은 AGENTS.md에, 필요할 때만 로드되어야 하는 절차는 Skills에 넣으세요. Codex 가이드에서 둘 다 다룹니다.

아니요. 규칙은 대화에 추가되는 .mdc 파일이고, Skills는 관련 있을 때나 호출할 때 에이전트가 사용하는 폴더입니다. Cursor 가이드를 참고하세요.

이 가이드가 도움이 되었나요?