openai/skills 저장소, 공식 디렉토리에서 deprecated된 이유

Codex용 스킬 카탈로그가 사라진 이유

OpenAI가 2025년 하반기부터 공개한 Codex용 오픈소스 저장소 openai/skills가 공식적으로 deprecated 처리된 소식이 관련 커뮤니티를 통해 전해졌어요. 이 저장소는 한때 Codex CLI에서 에이전트가 자동으로 불러와 사용할 수 있는 Agent Skills 카탈로그 역할을 했고, GitHub에서 25.7k 스타와 1.7k 포크를 기록했던 만큼 영향력이 꽤 컸어요.

어떤 저장소였나

이 저장소의 핵심 컨셉은 Skills = 폴더 단위의 명령·스크립트·리소스 모음이에요. 사용자는 Codex 내에서 $skill-installer 명령 하나로 원하는 스킬을 설치할 수 있었고, .system, .curated, .experimental 디렉터리로 구분해 기본 제공·선별·실험적 스킬을 구분해 관리했어요.

대표적으로 자주 쓰인 스킬들은 gh-address-comments, create-plan, gh-fix-ci 등 GitHub 워크플로와 기획/실행 보조 기능이 많았고, 팀이나 개인이 자주 쓰는 워크플로를 SKILL.md 형태로 한 번 작성해두면 Codex가 자동으로 불러 쓸 수 있다는 점에서 주목받았어요.

deprecated의 의미

README 상단에 명시된 deprecated 공지의 핵심은 **"앞으로는 openai/plugins 저장소를 사용하라"**는 방향 전환입니다. 기존 skills 저장소는 더 이상 새로운 스킬의 기본 배포처가 아니고, 참고용 카탈로그로만 남는다는 뜻이에요.

최종 커밋도 2026년 6월 24일(3개월 전)에 머물러 있고, 저장소 설명에서도 "Plugins directory for skills and apps"로 안내하고 있어요. 즉, 스킬 제작자들은 기존처럼 skills 저장소에 PR을 날리는 대신, openai/plugins 저장소로 대상 옮기고, 플러그인 번들 형태로 skill-only plugin을 배포해야 정식 지원 경로가 되는 거죠.

왜 구조를 바꿨나

OpenAI 입장에서 Skills를 단독 레포로 관리하는 것보다 플러그인 생태계로 통합하는 게 더 확장성이 높기 때문으로 보여요. 플러그인은 단순한 프롬프트 명령어가 아니라 권한 범위, 설정 UI, 배포 패키징까지 다룰 수 있는 구조라, 팀 단위 배포나 상용화에 적합해요.

실제로 Codex의 스킬 디렉토리도 ~/.codex/skills/.system·.curated·.experimental처럼 분류해 두었는데, 이 구조는 유지하면서 배포 저장소만 plugins로 이동한 셈이에요. 기존 사용자 입장에서는 이미 설치한 스킬이 동작하지 않게 된 것은 아니지만, 앞으로 새 스킬을 찾거나 제안하려면 새 저장소를 확인해야 해요.

어떤 프로젝트인지 한눈에

그래서 지금은?

만약 지금 Codex에서 커스텀 스킬을 만들고 싶다면, 기존 SKILL.md 포맷을 그대로 쓰면서 배포는 plugins 저장소 기반으로 하거나, 로컬 ~/.codex/skills/에 직접 둬서 쓰는 게 권장 경로예요. openai/skills 저장소는 역사적으로 의미가 크고, 여전히 스킬 구조와 작성법을 배우기 좋은 참고 자료로 남아 있지만, 새로운 프로젝트로 삼기엔 deprecated 저장소라는 점을 기억해두는 게 좋아요.

참고 링크

• openai/skills 저장소
• openai/plugins 저장소
• Codex 플러그인 제작 가이드
• Agent Skills 오픈 스탠다드