GitHub Copilot과 Claude Code는 모두 에디터 통합형 AI 코딩 어시스턴트(AI Coding Assistant)이지만, 커스터마이징 방식이 달라 항상 혼란스러웠기에 Claude Sonnet 4.6님에게 정리를 부탁했습니다.

비망록으로서 2026.5 시점에서의 「커스텀 지시(Custom Instructions)·프롬프트(Prompt)·스킬(Skill)·에이전트(Agent)」 사양을 기록해 둡니다.

Claude Code의 commands가 어느샌가 과거의 것이 되었다는 사실에 깜짝 놀랐습니다.

가끔은 이런 조사를 해보는 것도 좋겠다는 생각이 듭니다.

정보의 신선도에 대하여

본 기사는 2026년 5월 시점의 정보에 기반하고 있습니다. 두 도구 모두 업데이트가 빈번하므로, 반드시 최신 공식 문서를 참조해 주세요.

판단 기준축:
언제 읽어들이는가 / 누가 실행하는가 / 어디서 사용하는가

페르소나 전환 (▲) 은 Copilot의 .github/agents/*.agent.md가 우세합니다.

Claude Code에는 대화 전체의 모드·도구·모델을 일괄 선언하는 전용 UI가 현재로서는 없으며,

CLAUDE.md

• skills

의 조합으로 대체하는 것이 현재의 베스트 프랙티스(Best Practice)입니다.

GitHub Copilot의 커스터마이징에는 「커스텀 지시·프롬프트 파일·에이전트 스킬·AGENTS.md」의 4종류가 있습니다. 각각 역할이 다릅니다.

Copilot에 상시 적용되는 규칙을 기술하는 파일입니다. 우선순위는 다음 순서로 높은 쪽이 승리합니다 (충돌 시에만 덮어쓰기, 통상적으로는 모든 레이어가 병합됩니다).

개인 설정 (GitHub.com)
↓
.github/instructions/*.instructions.md (경로 지정)
...

리포지토리 루트의 .github/

에 두는 것만으로 해당 리포지토리의 모든 요청에 적용됩니다.

# Copilot Instructions
- TypeScript를 사용할 것. any 타입 금지
- 테스트는 Vitest로 작성할 것
...

applyTo

frontmatter에서 파일 패턴을 지정하면 대상 파일에 대해서만 적용됩니다.

---
applyTo: "**/*.test.ts"
---
...

---
applyTo: "src/api/**"
---
...

GitHub.com의 계정 설정에서 모든 리포지토리에 걸쳐 적용할 수 있는 개인 규칙을 정의할 수 있습니다.

파일 형식: .github/prompts/*.prompt.md

커스텀 지시(Custom Instructions)가 '항상 ON' 상태인 것과 달리, 프롬프트 파일은 수동으로 호출하는 일회성 프롬프트입니다. 채팅창에서 /를 입력하면 목록이 표시됩니다.

지원 환경: VS Code / Visual Studio / JetBrains만 지원 (GitHub.com의 Copilot은 미지원)

# 코드 리뷰 체크리스트
다음 관점에서 코드를 리뷰해 주세요.
- [ ] 보안 (인젝션, 인증 누락)
...

{{selection}}과 같이 템플릿 변수도 사용할 수 있습니다.

파일 형식: 리포지토리 루트 또는 임의의 하위 디렉토리에 AGENTS.md

AGENTS.md는 GitHub Copilot 전용이 아니라, Claude Code, Gemini CLI 등 여러 AI 에이전트가 공통으로 읽는 것을 상정한 범용 포맷입니다. GitHub는 2025년 8월에 Copilot coding agent에서의 AGENTS.md 지원을 공식 발표했습니다.

# Project Agent Instructions
## Setup
npm install && npm run build
...

.github/copilot-instructions.md와 AGENTS.md가 공존하는 경우, Copilot은 **두 파일을 모두 읽어 병합(Merge)**합니다. 여러 에이전트로 동일한 리포지토리를 다룬다면 AGENTS.md에 공통 규칙을 작성하고, Copilot 고유의 추가 설정을 .github/copilot-instructions.md에 작성하는 방식의 활용이 권장됩니다.

파일 형식: <임의의 디렉토리>/SKILL.md

Copilot coding agent, Copilot CLI, agent mode (VS Code)에서 사용할 수 있는 태스크 특화형 능력 정의입니다. Agent Skills Open Standard를 준수하며, Claude Code 등 다른 에이전트와 스킬을 공유할 수 있습니다.

---
name: generate-tests
description: 지정된 소스 파일의 유닛 테스트를 생성한다
...

Copilot의 툴 모델(Tool Model)은 **선언형(Declarative)**입니다. 파일 읽기/쓰기, 터미널 실행, 웹 검색 등의 내장 툴을 스킬 지시문 안에서 참조하는 것만으로 충분하며, JSON 스키마 정의는 필요하지 않습니다.

Claude Code의 커스터마이징은 'CLAUDE.md, 스킬, 커맨드, 내장 슬래시 커맨드'로 구성됩니다.

파일 형식: CLAUDE.md (프로젝트 루트 / ~/.claude/CLAUDE.md)

GitHub Copilot의 copilot-instructions.md에 해당하는, Claude에 대한 상시 로드 지시사항입니다. 사용자 레벨(~/.claude/)과 프로젝트 레벨이 모두 자동으로 병합됩니다.

# 프로젝트 지시사항
## 기술 스택
- TypeScript 5.x / Node.js 22
...

Claude Code는 AGENTS.md도 인식합니다. AGENTS.md가 존재하는 경우 CLAUDE.md와 함께 참조합니다.

파일 형식: .claude/skills/<스킬명>/SKILL.md

Claude Code의 스킬은 Agent Skills Open Standard를 준수하면서도, **독자적인 확장 필드 (extension fields)**를 가집니다.

---
name: generate-tests
description: 지정된 소스 파일의 유닛 테스트를 생성한다
...

Claude Code 고유의 중요한 필드가 두 가지 있습니다.

---
name: security-audit
description: 코드베이스의 보안 감사를 실행한다
...

context: fork를 사용하면, 스킬은 메인 대화의 이력을 가지지 않는 **독립된 서브 에이전트 (sub-agent)**로서 실행됩니다. 대규모 코드베이스 조사와 같이 메인 대화의 컨텍스트 (context)를 오염시키고 싶지 않은 작업에 적합합니다.

스킬에는 두 가지 실행 경로가 있습니다.

• 자동 트리거 (Automatic trigger): 사용자의 메시지를 읽고 Claude가 description (설명)에 기반하여 판단하여 자동으로 실행
• 수동 실행 (Manual trigger): /스킬명으로 명시적으로 호출

스킬을 생성하면 자동으로 슬래시 명령어 (slash command)로도 등록됩니다.

파일 형식: .claude/commands/<명령어명>.md

명령어와 스킬은 통합되어 있습니다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 모두 /deploy로서 기능하며 동작은 동일합니다. 기존의 .claude/commands/ 파일은 그대로 동작합니다. 새로 생성한다면 .claude/skills/ 하위의 SKILL.md 형식을 권장합니다 (context: fork 등의 고급 기능을 사용할 수 있기 때문입니다).

Claude Code에는 처음부터 사용할 수 있는 슬래시 명령어가 60개 이상 있습니다. 대표적인 예시는 다음과 같습니다.

이전에는 서로 다른 개념이었으나, 현재는 통합되었습니다.

.claude/commands/foo.md와 .claude/skills/foo/SKILL.md는 모두 /foo로 동작합니다.

AGENTS.md → 멀티 에이전트 대응을 위한 범용 형식. Copilot, Claude Code, Gemini CLI 등이 공통으로 읽음
CLAUDE.md → Claude Code 전용 상세 지침. AGENTS.md보다 더 상세한 제어가 가능

두 파일이 공존하는 경우, Claude Code는 두 파일을 병합(merge)하여 사용합니다.

github/awesome-copilot과 hesreallyhim/awesome-claude-code가 각각의 생태계 중심입니다. 또한, VoltAgent/awesome-agent-skills에는 1,000개 이상의 스킬이 모여 있으며, 두 에이전트 모두에서 유용하게 사용할 수 있는 것들도 다수 존재합니다.

SKILL.md의 기본 형식 (name, description frontmatter + Markdown 지침 본문)은 두 에이전트 모두에서 동작합니다. 다만, context: fork나 agent:와 같은 Claude Code 독자 필드는 Copilot에서 무시됩니다 (에러는 발생하지 않습니다).

GitHub Copilot과 Claude Code의 커스터마이징 기능을 정리하면, 다음과 같은 설계 사상의 차이가 보입니다.

GitHub Copilot: IDE에 깊게 통합된 플로우(flow) 중심의 설계. 파일 유형별로 세밀한 지침 전환에 특화됨.
Claude Code: 터미널 퍼스트(terminal-first) 방식의 자율 에이전트 설계. context: fork를 통한 서브 에이전트 분리 등, 대규모 및 복잡한 태스크 위임에 강점.

어느 쪽이 더 우월한가의 문제가 아니라, 태스크의 성격에 따라 구분하여 사용하거나 두 가지를 조합하는 것이 2026년 현재의 베스트 프랙티스(best practice)입니다. Claude Code는 Copilot Pro+ / Enterprise 플랜에서 외부 에이전트로 호출할 수 있게 되었으므로, Copilot 워크플로우 내에서 Claude Code로 태스크를 위임하는 구성도 가능합니다.

• GitHub Copilot features (GitHub Docs)

• Use prompt files in VS Code (VS Code Docs)

• Use Agent Skills in VS Code (VS Code Docs)

• Adding repository custom instructions for GitHub Copilot (GitHub Docs)

• About agent skills (GitHub Docs)

• Copilot coding agent now supports AGENTS.md (GitHub Changelog)

• Extend Claude with skills (Claude Code Docs)

• github/awesome-copilot

• hesreallyhim/awesome-claude-code

• VoltAgent/awesome-agent-skills (1,000+ skills)