가이드

모든 AI 코딩 에이전트의 Agent Skills(SKILL.md): Claude Code, Codex, Cline, Amp, OpenHands (2026)

각 AI 코딩 에이전트는 SKILL.md skill을 어디에서 찾으며, 하나의 skill 폴더가 모든 에이전트에서 작동할 수 있습니까?

이 에이전트들은 모두 name과 description이 있는 YAML frontmatter를 가진 SKILL.md 파일이 담긴 폴더를 읽습니다. Claude Code는 .claude/skills/와 ~/.claude/skills/를 사용합니다. Codex, Amp, OpenHands는 저장소의 .agents/skills/와 개인용 ~/.agents/skills/를 사용합니다. Cline은 .cline/skills/와 ~/.cline/skills/를 사용하며 .claude/skills/도 읽습니다. Amp도 .claude/skills/를 읽습니다. 따라서 .agents/skills/의 skill은 Codex, Amp, OpenHands를, .claude/skills/의 사본은 Claude Code, Cline, Amp를 지원합니다.

이 페이지는 영어 가이드를 번역한 것입니다. 명령어, 설정 키, 코드는 원문 그대로이며 내용이 다를 경우 영어판을 기준으로 합니다. 영어 원문 보기 → · 다른 언어: 简体中文 · 日本語 · Español · Português (Brasil)

설정 변경 소식을 가장 먼저 받아 보세요

이 도구들의 설정, 플래그, 권한 규칙이 바뀌면 주 1회 이메일(영어)로 알려 드립니다. 모든 내용은 공식 문서로 확인합니다.

빠른 답변: skill 폴더 위치

  • Claude Code: .claude/skills/NAME/SKILL.md(프로젝트)와 ~/.claude/skills/NAME/SKILL.md(개인). 플러그인도 skill을 제공하며 /plugin-name:skill-name으로 호출합니다.
  • OpenAI Codex: Codex를 실행한 폴더의 .agents/skills, 저장소 루트까지의 상위 폴더, ~/.agents/skills, /etc/codex/skills(관리자), 번들된 시스템 skill.
  • Cline: 프로젝트의 .cline/skills/(권장), .clinerules/skills/ 또는 .claude/skills/, 그리고 전역 ~/.cline/skills/.
  • Amp: 프로젝트와 상위 폴더의 .agents/skills/와 .claude/skills/, ~/.config/agents/skills/, ~/.agents/skills/, ~/.config/amp/skills/, ~/.claude/skills/, 그리고 amp.skills.path에 나열된 폴더.
  • OpenHands: 저장소의 .agents/skills/NAME/SKILL.md(레거시 .openhands/skills와 .openhands/microagents도 여전히 작동)와 사용자용 ~/.agents/skills.

어디서나 작동하는 SKILL.md 하나

다섯 에이전트 모두 같은 최소 파일을 받아들입니다. name과 description이 있는 YAML frontmatter, 그다음 Markdown 지침입니다. Cline과 OpenHands는 이름이 폴더 이름과 일치해야 하므로 name을 폴더 이름과 같게 유지하십시오.

.agents/skills/release-notes/SKILL.md

---
name: release-notes
description: Draft release notes from recent commits. Use when the user asks for release notes or a changelog.
---

1. Read the commits since the last tag.
2. Group changes into Features, Fixes and Other.
3. Write the notes in plain Markdown.
  • Codex, Amp, OpenHands용으로 .agents/skills/release-notes/에 둡니다.
  • Claude Code용으로 같은 폴더를 .claude/skills/에 둡니다. Cline과 Amp도 이 폴더를 읽습니다.
  • description은 트리거로 작성하십시오. skill이 하는 일과 사용할 시점을 적습니다. Claude Code, Codex, Cline, Amp는 이 텍스트로 skill 로드 여부를 결정합니다.

skill을 실행하는 방법

  • Claude Code: /skill-name을 입력하거나, 요청이 description과 일치할 때 Claude가 로드하게 합니다. 이름 뒤의 텍스트는 $ARGUMENTS에 채워집니다.
  • Codex: /skills를 실행하거나 $와 skill 이름을 입력하거나, Codex가 description을 보고 고르게 합니다.
  • Cline: /를 입력하고 skill을 고르거나, 요청이 일치할 때 Cline이 로드하게 합니다.
  • Amp: 모델은 각 skill의 name과 description을 보고, skill이 호출되면 전체 SKILL.md를 로드합니다. skill은 amp skill add <source>로 설치합니다.
  • OpenHands: frontmatter에 triggers 목록을 추가하면 메시지에 해당 키워드 중 하나가 나타날 때만 skill이 로드됩니다.

에이전트가 skill을 스스로 사용하지 못하게 하기

  • Claude Code: frontmatter에 disable-model-invocation: true. 그러면 사용자만 실행할 수 있습니다.
  • Codex: agents/openai.yaml에 policy.allow_implicit_invocation: false. 명시적인 $skill 호출은 계속 작동합니다. skill을 완전히 끄려면 ~/.codex/config.toml에 enabled = false인 [[skills.config]] 항목을 추가합니다.
  • Cline: 채팅 아래 저울 아이콘 메뉴의 Skills 탭에서 skill을 끕니다.
  • Amp: Claude 호환 폴더를 건너뛰려면 amp.skills.disableClaudeCodeSkills를 설정합니다.
  • OpenHands: triggers 목록을 사용해 일치하는 키워드에서만 skill이 로드되게 합니다.

이름이 충돌할 때 우선하는 사본

  • Claude Code: enterprise가 personal보다, personal이 project보다 우선합니다. 같은 이름의 .claude/commands/ 파일보다 skill이 우선합니다.
  • Codex: 같은 이름의 skill은 병합되지 않으며 선택기에 둘 다 표시됩니다.
  • Cline: 같은 이름이면 전역 skill이 프로젝트 skill보다 우선합니다.
  • Amp: 검색 순서에서 처음 찾은 skill이 우선합니다.

주의할 점

  • Codex는 초기 skill 목록을 context window의 2%(크기를 알 수 없으면 8,000자)로 제한하며, skill이 많으면 description부터 줄입니다.
  • Cline은 SKILL.md를 5k token 미만으로 유지하도록 권장합니다. 각 skill의 메타데이터는 시작 시 약 100 token을 사용합니다.
  • Amp는 다른 곳에서 amp skills list를 실행해도 실행 중인 스레드의 skill을 다시 로드하지 않습니다. Amp에게 skill을 다시 로드하라고 요청하십시오.
  • Claude Code는 사용자 지정 명령을 skill에 통합했으므로 .claude/commands/*.md 파일은 여전히 /name 명령을 만듭니다.

에이전트별 전체 skill 가이드

출처

이 가이드에서 확인한 공식 문서(영어)입니다. 영어판 확인일: 2026-10-18

다른 한국어 가이드