Codex에 공식적으로 도입된 Skills 기능

1 month ago 12

Agent Skills은 Codex에 작업별 전문 능력을 추가해 특정 워크플로를 안정적으로 수행하게 하는 확장 구조
각 스킬은 SKILL.md 파일과 선택적 스크립트·리소스·에셋으로 구성되어, 팀이나 커뮤니티 간 공유 가능
Codex는 스킬을 명시적 호출(/skills 명령 또는 $ 입력)과 암묵적 호출(작업 설명과 일치 시 자동 사용) 방식으로 실행
스킬은 REPO, USER, ADMIN, SYSTEM 등 여러 저장 위치와 우선순위 체계를 통해 관리되며, $skill-creator로 새 스킬을 생성 가능
이 기능은 Codex의 CLI와 IDE 확장 모두에서 사용 가능하며, GitHub 등에서 스킬을 설치해 기능을 확장할 수 있음

Agent Skills 개요

Agent Skills는 Codex에 새로운 기능과 전문성을 부여하는 구조
- 스킬은 특정 작업을 수행하기 위한 지침, 리소스, 선택적 스크립트를 패키징
- 팀 또는 커뮤니티 간 공유 가능하며, open Agent Skills standard를 기반으로 함
Codex의 CLI와 IDE 확장 모두에서 사용 가능

스킬 구조와 구성 요소

각 스킬은 SKILL.md 파일을 중심으로 구성되며, 다음과 같은 폴더 구조를 가짐
- SKILL.md: 필수, 지침 및 메타데이터 포함
- scripts/: 선택적 실행 코드
- references/: 선택적 문서
- assets/: 선택적 템플릿 및 리소스
Codex는 progressive disclosure 방식을 사용해 컨텍스트를 효율적으로 관리
- 시작 시 스킬의 이름과 설명만 로드하고, 필요 시 전체 지침을 읽음

스킬 호출 방식

명시적 호출 (Explicit invocation)
- /skills 명령이나 $ 입력으로 스킬을 직접 지정
- Codex 웹 및 iOS 버전은 아직 명시적 호출을 지원하지 않지만, 저장소에 포함된 스킬은 프롬프트로 사용 가능
암묵적 호출 (Implicit invocation)
- 사용자의 작업이 스킬 설명과 일치할 때 Codex가 자동으로 해당 스킬을 사용

스킬 저장 위치와 우선순위

Codex는 여러 위치에서 스킬을 로드하며, 우선순위가 높은 위치의 스킬이 동일 이름의 하위 스킬을 덮어씀
주요 스코프 및 위치
- REPO: $CWD/.codex/skills, $CWD/../.codex/skills, $REPO_ROOT/.codex/skills
- USER: $CODEX_HOME/skills 또는 ~/.codex/skills
- ADMIN: /etc/codex/skills
- SYSTEM: Codex에 기본 포함된 스킬
각 스코프는 개인, 팀, 시스템 수준의 관리 목적에 따라 사용

스킬 생성 방법

Codex 내장 $skill-creator 스킬을 사용해 새 스킬을 자동 생성 가능
- $plan 스킬과 결합하면 스킬 생성 전 계획을 수립
수동 생성 시, 유효한 위치에 폴더를 만들고 SKILL.md 파일을 작성
- 필수 항목: name, description
- 선택 항목: metadata.short-description
스킬은 Agent Skills specification을 기반으로 함

스킬 설치 및 예시

$skill-installer 스킬을 사용해 GitHub의 공개 스킬 저장소에서 스킬 설치 가능
- 예: $skill-installer linear
- 다른 저장소의 스킬도 설치 가능
내장 스킬 예시
- $plan: 새로운 기능 개발이나 복잡한 문제 해결을 위한 계획 수립
- $skill-installer linear: Linear 컨텍스트 접근
- $skill-installer notion-spec-to-implementation: Notion 데이터 접근

Codex 개발자에게의 의미

Agent Skills는 Codex의 확장성과 협업성을 높이는 핵심 구성요소
개발자는 자신만의 스킬을 정의해 자동화된 개발 워크플로를 구축 가능
CLI·IDE 통합, GitHub 연동, 표준화된 스킬 사양을 통해 Codex 생태계 확장 가능성 강화

Read Entire Article