월 US$9.99에 모든 Premium Skill을 이용하세요. 언제든지 취소할 수 있습니다.플랜 보기

Codex Skills: OpenAI Codex에서 Agent Skills 추가하고 사용하기

Codex는 ~/.agents/skills/에서 Skills를 읽고, 이전 경로인 ~/.codex/skills/도 계속 읽으며, $와 이름을 입력하면 Skill을 실행합니다. 이 가이드에서는 Skill을 설치하고, 로드되었는지 확인하고, 무엇을 Skill에 넣고 무엇을 AGENTS.md에 넣을지 정하는 방법을 알아봅니다.

대상
Codex 사용자
소요 시간
완료까지 8분

짧은 답변

  1. 1모든 저장소에서 쓰려면 Skill 폴더를 ~/.agents/skills/에, 특정 저장소에서만 쓰려면 그 저장소의 .agents/skills/에 두세요.
  2. 2Codex는 SKILL.md에 name(최대 64자)과 description(최대 1,024자)이 모두 필요합니다.
  3. 3$와 Skill 이름을 입력해 실행하거나, /skills로 목록에서 고르세요.
  4. 4바로 쓸 수 있는 Skill이 필요한가요? 명령어 하나로 설치할 수 있는 Codex Skills를 둘러보세요.
여기서 시작:설치찾는 위치Skills vs AGENTS.md

시작하기 전에

Skills는 세 곳에서 작동합니다. Codex CLI, Codex IDE 확장, 그리고 ChatGPT 데스크톱 앱의 Codex입니다. CLI로 Skillry에서 설치하려면 macOS 또는 Windows와 Node.js 22 이상도 필요합니다.

Codex에 Skills를 추가하는 방법

Codex와 Skillry CLI는 같은 기본 폴더 ~/.agents/skills/를 사용하므로 별도의 플래그가 필요 없습니다. 편한 방법을 고르세요.

Codex가 이미 열려 있다면 가장 쉬운 방법
  1. 1

    Skillry에서 Skill을 열고 설치 프롬프트 복사를 선택한 다음, 대화 상자에서 복사를 선택하세요.

  2. 2

    Codex에 붙여 넣고 보내세요. 에이전트가 Skillry의 설치 안내를 읽고 알맞은 명령어를 직접 실행합니다.

    설치 프롬프트
    Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    브라우저에서 기기 코드 승인을 요청하면 승인하세요.

    다음이 보여야 합니다: Codex에서 설치한 버전과 사용한 폴더(~/.agents/skills/ 아래)를 알려 주는 메시지.

Codex에는 OpenAI 카탈로그용 자체 설치 도구인 $skill-installer도 있습니다. 이 도구는 Codex가 계속 읽는 이전 폴더 ~/.codex/skills/에 Skill을 설치하므로, 두 설치 도구로 받은 Skill이 함께 표시됩니다.

Codex가 찾았는지 확인하기

CLI나 IDE 확장에서는 /skills를 입력하거나, $를 입력하고 이름을 치기 시작하세요. ChatGPT 데스크톱 앱에서는 사이드바의 Skills를 여세요. Codex는 새 Skill을 알아서 인식하며, 보이지 않으면 Codex를 다시 시작하세요.

Codex에서 Skill을 실행하는 방법

$, Skill 이름, 그리고 요청을 입력하세요.

Codex CLI
$launch-page Parcelo, a parcel-tracking dashboard for small online shops

작동하는 걸 확인했다면 평소 말로 요청해도 Codex가 description이 일치하는 Skill을 고릅니다. Skill이 많이 설치되어 있으면 Codex는 전체 목록이 컨텍스트 창의 약 2%에 들어가도록 description을 줄입니다. 잘려도 살아남도록 주된 용도를 description의 첫 문장에 넣으세요.

Codex가 Skills를 찾는 위치

Codex는 다섯 범위에서 Skills를 모읍니다. 평소에는 개인 폴더와 저장소 폴더, 두 가지를 쓰게 됩니다.

범위위치
저장소Codex를 시작한 폴더부터 저장소 루트까지 모든 폴더의 .agents/skills/
개인~/.agents/skills/
개인, 이전 경로~/.codex/skills/, 계속 읽음(문서에는 없지만 Codex 소스 코드에서 확인됨)
관리자/etc/codex/skills/
시스템$skill-creator, plan 등 Codex에 기본 포함

Codex는 이름이 같은 두 Skill을 합치지 않습니다. 선택 목록에 둘 다 나타날 수 있으니, 원하지 않는 사본은 삭제하거나 이름을 바꾸세요.

Codex Skills vs AGENTS.md

Codex는 매 실행을 시작할 때 AGENTS.md를 읽으므로, 항상 적용되는 짧은 규칙에 적합합니다. Skill은 작업에 필요할 때만 로드되므로, 반복하는 긴 절차에 적합합니다.

Skill

필요할 때 로드

  • .agents/skills/에 있는 폴더
  • 작업이 일치하거나 $name을 입력할 때 로드
  • 반복적인 여러 단계 작업에 적합
AGENTS.md

매 실행 시작 시 읽음

  • ~/.codex/AGENTS.md를 먼저 읽고, 저장소 루트부터 시작한 폴더까지 폴더마다 파일 하나씩
  • 가까운 파일이 앞의 파일을 덮어씀. 기본 합계 32 KiB
  • 테스트 명령어, 코드 스타일, 제한 같은 짧은 규칙에 적합

잘 맞는 구분 방법: AGENTS.md는 한 화면 정도의 규칙으로 유지하고, 단계별 내용은 모두 Skills로 옮기세요. 자세한 내용은 Skills vs 지침에서 다룹니다.

Codex Skill이 보이지 않나요? 증상별로 확인하세요

Skill이 보이지 않는 건 대개 폴더가 잘못되었거나 압축이 한 단계 더 깊이 풀린 경우입니다. 왼쪽 열에서 지금 보이는 증상을 찾으세요.

보이는 증상해결 방법
/skills에 없음~/.agents/skills/<name>/로 옮기고 ZIP 때문에 폴더가 한 단계 더 생기지 않았는지 확인하세요
description 없이 표시됨frontmatter를 고치세요. Codex는 name과 description이 모두 필요합니다
프로젝트 Skill이 없음저장소 안에서 Codex를 시작하세요
ChatGPT 데스크톱 앱에서 $로 아무것도 찾을 수 없음보고된 버그입니다(openai/codex#28505). /skills를 확인하고, 다시 시작하거나, ~/.codex/skills/에 사본을 두어 보세요(아직 직접 테스트하지는 않았습니다)

자주 묻는 질문

Codex Skills는 어디에 저장되나요?

내 Skill은 ~/.agents/skills/, 저장소 안에서는 .agents/skills/, 관리자용은 /etc/codex/skills/입니다. Codex는 $skill-installer가 Skill을 설치하는 이전 경로 ~/.codex/skills/도 읽습니다.

Codex Skills와 AGENTS.md는 어떻게 다른가요?

AGENTS.md는 매 실행을 시작할 때 읽힙니다. Skill은 작업에 필요할 때만 로드됩니다.

Codex Skills는 ChatGPT에서 작동하나요?

독립형 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE 확장에서 작동합니다. 웹이나 모바일의 ChatGPT에서 쓰려면 플러그인에 담아 배포하세요.

나만의 Codex Skill은 어떻게 만드나요?

$skill-creator에게 요청하세요. Codex에 기본 포함된 시스템 Skill 중 하나입니다.

출처

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

이전Claude Code다음Cursor

다음 읽을거리

모든 가이드
Skills vs 지침CLAUDE.md, AGENTS.md, Cursor 규칙은 매번 로드되고, Skills는 필요할 때만 로드됩니다.Skills 사용법Skill에 무엇을 줘야 하는지, 만든 파일을 어떻게 확인하는지, 더 나은 두 번째 초안을 얻는 방법.문제 해결목록에 없거나, 실행되지 않거나, 중간에 실패하나요? 보이는 증상으로 해결 방법을 찾으세요.에이전트 비교Skills 관점에서 본 Claude Code vs Codex vs Cursor: 폴더, 명령어, 이름 규칙, 클라우드 사용.