Skills가 공식적으로 Codex에 도입됩니다
Source: Hacker News
스킬 구조
스킬은 SKILL.md 파일(필수)과 선택적인 하위 폴더를 포함하는 폴더입니다:
SKILL.md– 필수: 마크다운 지침 + 메타데이터scripts/– 선택적: 실행 가능한 코드references/– 선택적: 문서assets/– 선택적: 템플릿, 리소스
스킬 호출
명시적 호출
프롬프트에 스킬을 직접 포함할 수 있습니다. 스킬을 선택하려면 /skills 슬래시 명령을 실행하거나 $를 입력해 스킬을 언급하세요. (Codex 웹 및 iOS는 아직 명시적 호출을 지원하지 않지만, 레포에 체크인된 어떤 스킬이든 Codex에 요청할 수 있습니다.)
암시적 호출
사용자의 작업이 스킬 설명과 일치할 때 Codex가 사용 가능한 스킬을 자동으로 선택할 수 있습니다. 어느 경우든 Codex는 호출된 스킬의 전체 지침과 스킬에 체크인된 추가 참조를 읽어들입니다.
스킬 범위 및 우선순위
Codex는 여러 위치에서 스킬을 로드합니다. 동일한 이름의 스킬이 여러 개 있을 경우, 우선순위가 높은 범위의 스킬이 다른 스킬을 덮어씁니다.
| 범위 | 위치 | 권장 사용 |
|---|---|---|
| REPO | $CWD/.codex/skills | 현재 작업 디렉터리(예: 마이크로서비스 또는 모듈). |
| REPO | $CWD/../.codex/skills | 현재 레포의 상위 폴더 – 관련 프로젝트가 공유하는 영역. |
| REPO | $REPO_ROOT/.codex/skills | 레포지토리 루트 – 모든 하위 폴더에서 사용할 수 있는 스킬. |
| USER | $CODEX_HOME/skills (~/.codex/skills on macOS/Linux) | 모든 레포지토리에서 적용되는 개인 스킬. |
| ADMIN | /etc/codex/skills | 자동화, SDK 스크립트 또는 기본 관리 도구용 시스템 전역 스킬. |
| SYSTEM | Bundled with Codex | 광범위한 사용자를 위한 스킬(예: skill-creator, plan). |
스킬 만들기
내장 $skill-creator 사용하기
$skill-creator 스킬을 Codex 안에서 실행하고, 스킬이 수행하길 원하는 내용을 설명하면 Codex가 이를 부트스트랩합니다. 먼저 $plan과 함께 사용하여 계획을 생성하세요.
수동 생성
유효한 스킬 위치에 폴더를 만들고 SKILL.md 파일을 추가합니다. 파일에는 name과 description이 포함되어야 하며(metadata는 선택 사항입니다).
---
name: skill-name
description: Description that helps Codex select the skill
metadata:
short-description: Optional user‑facing description
---
Skill instructions for the Codex agent to follow when using this skill.Codex 스킬은 Agent Skills specification을 기반으로 합니다. 자세한 내용은 문서를 참고하세요.
내장 스킬 및 설치 프로그램
GitHub에서 선별된 세트를 다운로드하여 내장 스킬 목록을 확장할 수 있습니다:
$skill-installer linear설치 프로그램은 다른 저장소에서도 스킬을 가져올 수 있습니다.
예시 사용 사례
새로운 기능 계획하기
Codex는 새로운 기능이나 복잡한 문제에 대한 연구와 계획 수립을 돕는 내장 $plan 스킬을 제공합니다.
Codex 작업을 위한 Linear 컨텍스트 접근
$skill-installer linear더 많은 컨텍스트를 위해 Notion에 접근하도록 Codex 설정
$skill-installer notion-spec-to-implementation