Codex를 사용하는데 아직도 이 스킬을 모르시나요? AI 코딩 에이전트를 사용할 때마다 비슷한 요청을 반복해서 입력해야 하는 경우가 있습니다. 

코드 리뷰를 요청할 때마다 확인해야 할 기준을 다시 설명하고, 오류가 발생하면 로그를 분석하는 순서를 매번 전달해야 합니다. 이럴 때, Codex Skills을 시간을 꽤 아낄 수 있습니다. 

이번 글에서는 Codex 사용자를 위해 개발 업무에서 활용도가 높은 Codex 스킬 TOP 5를 정리했습니다.

Codex Skills 핵심 요약

• Codex Skills는 반복 입력하던 프롬프트, 체크리스트, 테스트 명령어를 하나의 모듈로 묶어 AI 코딩 에이전트가 같은 작업을 매번 일관되게 수행하도록 만드는 도구입니다.
• 스킬은 skill-creator로 생성하거나 SKILL.md 파일을 직접 작성해 만들 수 있고, skill-installer로 외부 스킬을 설치할 수도 있습니다.
• 스킬을 직접 부르는 명시적 호출과 Codex가 설명을 보고 알아서 고르는 암묵적 호출이 있으며, 암묵적 호출이 잘 작동하려면 설명에 핵심 키워드와 실행 조건을 앞쪽에 명확히 적어야 합니다.
• 플러그인 시스템을 이용하면 여러 스킬과 외부 도구를 하나의 패키지로 묶어 업무에 맞게 한 번에 설치해 쓸 수 있습니다.
• 개발 업무에 바로 쓸 수 있는 TOP 5 스킬은 gh-fix-ci, code-review, gh-address-comments, frontend-testing-debugging, react-best-practices이며, 각각 CI 오류 수정부터 React 성능 점검까지 어떤 상황에 활용하는지 알 수 있습니다.
• 스킬을 설계할 때는 하나의 스킬에 하나의 업무만 담고, 실행 조건을 명확히 적으며, 실제 환경에 영향을 주는 자동 실행 범위를 미리 확인해야 합니다.

Codex Skills이란 무엇인가요?

Codex Skill은 AI 코딩 에이전트 Codex가 특정 작업을 일관된 방식으로 반복 수행하도록 미리 정의해 둔 재사용 가능한 지식 모듈입니다. 사용자가 반복해서 입력하던 프롬프트, 체크리스트, 테스트 명령어, 참고 문서, 템플릿을 하나의 스킬로 정리해 두면, 프롬프트를 일일이 작성하지 않아도 Codex가 같은 작업을 매번 안정적으로 수행합니다. 

Codex Skills를 사용하는 이유

1. 반복 작업을 매번 같은 방식으로 처리할 수 있습니다.

자주 쓰는 작업의 지침과 절차를 스킬로 한 번 정의해 두면, 같은 프롬프트를 매번 새로 작성할 필요가 없습니다. 

스킬은 명령과 스크립트, 참고 자료를 묶어 Codex가 반복 작업을 항상 동일하게 수행하도록 표준화하는 역할을 합니다. 작업자마다, 세션마다 결과가 달라지는 이른바 '프롬프트 드리프트'를 줄여 일관된 결과를 얻을 수 있습니다.

2. 전문 작업을 Codex에 위임할 수 있습니다

보안 점검, 테스트 작성, 문서화처럼 매번 신경 써서 챙겨야 하던 작업을 스킬로 만들어두면 Codex가 정해진 방식대로 대신 처리합니다. 작업마다 필요한 절차와 참고 자료를 스킬이 함께 들고 있어, 일반적인 범용 에이전트가 아니라 해당 작업에 특화된 방식으로 일을 맡길 수 있습니다.

3. 여러 저장소에 걸쳐 재사용하고 공유할 수 있습니다. 

스킬은 폴더 단위라 git에 함께 커밋해 팀원과 공유할 수 있습니다. 저장소·사용자·관리자·시스템 등 여러 위치에서 스킬을 읽어오므로, 특정 프로젝트에만 적용할 스킬과 모든 작업에 적용할 개인 스킬을 구분해 둘 수 있습니다. 한 번 만든 작업 방식을 자산처럼 쌓아 여러 저장소에서 다시 활용하는 구조입니다.

Codex Skills 사용법

1. 직접 스킬 생성하기

가장 간단한 방법은 내장 생성기입니다. Codex에서 $skill-creator를 입력하면 생성기가 스킬이 어떤 일을 하는지, 언제 작동해야 하는지, 지침만으로 충분한지 아니면 스크립트가 필요한지를 물어보며 스킬을 만들어줍니다. 기본값은 지침만으로 구성하는 방식입니다.

직접 만들 수도 있습니다. 폴더를 하나 만들고 그 안에 SKILL.md 파일을 두면 됩니다. 이 파일에는 이름(name)과 설명(description)이 반드시 들어가야 합니다.

• name: skill-name
• description: 이 스킬이 언제 작동하고 언제 작동하지 않아야 하는지 설명합니다.

Codex가 따라야 할 작업 지침을 적습니다. 폴더 안에는 SKILL.md 외에 스크립트(scripts/), 참고 문서(references/), 템플릿 같은 자료(assets/)를 함께 넣을 수 있습니다. 

스킬을 추가하거나 수정하면 Codex가 변경을 자동으로 감지하며, 바로 반영되지 않으면 Codex를 다시 시작하면 됩니다.

2. 다른 사람이 만든 스킬 가져오기

OpenAI가 선별해 둔 스킬을 로컬에 설치하려면 내장 설치기인 $skill-installer를 사용합니다. 예를 들어 linear 스킬을 설치하려면 다음과 같이 입력합니다.

$skill-installer linear

이 설치기에 다른 저장소의 스킬을 내려받도록 요청할 수도 있습니다. 설치하면 Codex가 새 스킬을 자동으로 감지하며, 바로 나타나지 않으면 Codex를 다시 시작하면 됩니다.

스킬은 폴더 단위이므로, 공유된 스킬 저장소를 git으로 클론해 스킬 인식 경로에 두는 방법도 있습니다. 팀에서는 공용 스킬 저장소를 만들어두고 각자 클론해 자신의 스킬 폴더에 연결해 쓰는 방식을 많이 사용합니다. Codex는 심볼릭 링크된 스킬 폴더도 인식하므로, 원본을 한 곳에 두고 링크만 걸어 여러 곳에서 공유할 수 있습니다.

* 이미지 출처: openai/skills 깃허브 저장소 

가져올 스킬은 OpenAI 공식 모음(github.com/openai/skills)이나 여러 AI 코딩 도구를 아우르는 디렉터리(skills.sh)에서 찾을 수 있습니다. 스킬은 열린 표준(agentskills.io)을 따르기 때문에, 같은 SKILL.md 파일이 Codex뿐 아니라 Claude Code, Gemini CLI, Cursor, GitHub Copilot 등에서도 수정 없이 동작합니다.

3. 스킬 실행하기

스킬을 실행하는 방식은 명시적 호출과 암묵적 호출, 두 가지입니다.

1) 명시적 호출 

프롬프트에서 직접 스킬을 지정하는 방식으로, CLI나 IDE에서 /skills를 실행해 목록에서 고르거나 $스킬이름 형태로 입력해 원하는 스킬을 바로 부릅니다.

2) 암묵적 호출

사용자가 입력한 작업 내용이 스킬의 설명(description)과 맞아떨어지면 Codex가 알아서 해당 스킬을 선택합니다. 이 방식은 설명을 기준으로 매칭되므로, 설명을 쓸 때 어떤 작업에 쓰는 스킬인지와 핵심 키워드를 앞쪽에 명확히 적어두는 것이 중요합니다.

플러그인으로 확장된 Codex 스킬 시스템

기존에도 사용자는 Codex 스킬을 직접 만들거나, OpenAI가 선별한 스킬과 외부 저장소에 공개된 스킬을 설치해 사용할 수 있었습니다.

최근 OpenAI는 여기에 공식 플러그인 시스템을 추가해, 여러 스킬과 외부 도구를 더 쉽게 설치하고 활용할 수 있도록 Codex의 확장 범위를 넓혔습니다.

패키지로 묶어 제공되는 플러그인 시스템

Codex 플러그인은 특정 업무에 필요한 앱 연결, 스킬, 작업 지침, 워크플로를 하나의 패키지로 묶은 설치 단위입니다. 사용자는 필요한 플러그인을 설치한 뒤, 플러그인에 포함된 여러 스킬과 외부 도구를 함께 활용할 수 있습니다.

OpenAI는 2026년 6월 데이터 분석, 크리에이티브 제작, 영업 등 업무별로 구성된 6개의 직무 전용 플러그인을 공개했습니다. 이 플러그인 전체에는 62개의 주요 앱 연결과 110개의 스킬이 포함되어 있습니다.

이전에는 필요한 스킬을 직접 만들거나 개별적으로 설치해야 했다면, 이제는 업무에 맞는 플러그인을 설치해 관련 앱과 스킬, 작업 흐름을 하나의 패키지로 사용할 수 있습니다.

Codex 플러그인에서 유용한 Skill TOP 5

이번 TOP 5는 OpenAI Plugins 저장소에 실제로 포함된 스킬 가운데 개발 업무에서 활용 범위가 넓은 항목을 편집자 기준으로 선정했습니다.

1. gh-fix-ci, 

GitHub Actions의 CI 오류를 분석하고 수정하는 스킬

* 이미지 출처: OpenAI Plugins GitHub 저장소 – gh-fix-ci 스킬 

gh-fix-ci는 Pull Request에서 실패한 GitHub Actions 검사와 실행 로그를 확인하고, 오류 원인과 수정 방향을 정리하는 스킬입니다.

GitHub Actions에서 빌드나 테스트가 실패하면 개발자는 실패한 작업을 찾고 긴 로그를 직접 확인해야 합니다. 테스트 실패, 린트 오류, 패키지 문제처럼 원인이 다양하기 때문에 분석에 시간이 오래 걸릴 수 있습니다.

이 스킬은 GitHub에서 Pull Request 정보를 확인하고, GitHub CLI로 Actions 검사와 로그를 분석합니다. 이후 발견한 원인을 요약하고 수정 계획을 제시한 뒤, 사용자가 승인하면 관련 코드를 수정하고 검증 작업을 진행합니다.

어떤 플러그인에 포함되어 있나요?

* 이미지 출처: OpenAI Plugins GitHub 저장소 – GitHub 플러그인

gh-fix-ci는 OpenAI 공식 저장소의 GitHub 플러그인에 포함되어 있습니다. GitHub 플러그인은 Pull Request 정보 확인, 리뷰 의견 처리, CI 실패 분석처럼 GitHub 개발 과정에서 반복적으로 발생하는 작업을 Codex와 연결합니다.

gh-fix-ci의 주요 특징

• 현재 브랜치 또는 사용자가 지정한 Pull Request를 확인합니다.
• 실패한 GitHub Actions 검사와 실행 로그를 분석합니다.
• 오류 원인과 관련된 파일을 바탕으로 수정 계획을 먼저 제안합니다.
• 승인된 수정만 반영하고 테스트를 실행한 뒤 남은 위험 요소를 정리합니다.

gh-fix-ci를 사용할 때 주의할 점

• GitHub CLI 설치와 gh auth login 인증이 필요합니다.
• 저장소와 Actions 로그를 확인할 수 있는 GitHub 접근 권한이 필요합니다.
• GitHub Actions가 아닌 외부 CI 서비스는 상세 로그를 직접 분석하지 않습니다.
• 로그만으로 오류 원인을 확정하기 어렵다면 추가 검증이 필요합니다.

gh-fix-ci는 언제 사용하면 좋을까요?

GitHub Actions를 이용해 빌드, 테스트, 린트 검사를 자동화하는 프로젝트에서 활용하기 좋습니다. Pull Request의 CI가 실패했지만 로그가 길어 원인을 찾기 어렵거나, 수정해야 할 파일과 검증 범위를 빠르게 확인하고 싶을 때 사용할 수 있습니다.

2. code-review, 

CodeRabbit으로 코드 변경 사항을 검토하는 스킬

* 이미지 출처: OpenAI Plugins GitHub 저장소 – coderabbit-review 스킬 

code-review는 CodeRabbit CLI를 실행해 코드 변경 사항을 검토하고, 발견된 문제를 중요도에 따라 정리하는 스킬입니다.

코드를 작성한 뒤에는 기능이 정상적으로 동작하는지만 확인해서는 부족합니다. 오류 가능성, 예외 처리 누락, 테스트 부족, 유지보수 문제도 함께 살펴봐야 합니다.

이 스킬은 Codex가 직접 코드 리뷰 결과를 만들어내는 방식이 아닙니다. CodeRabbit CLI를 실행하고, 반환된 결과를 분석해 사용자에게 설명하는 방식으로 작동합니다.

어떤 플러그인에 포함되어 있나요?

* 이미지 출처: OpenAI Plugins GitHub 저장소 – CodeRabbit 플러그인

code-review는 OpenAI 공식 저장소의 CodeRabbit 플러그인에 포함되어 있습니다. 이 플러그인은 CodeRabbit CLI를 Codex 작업 흐름과 연결해, 변경된 코드의 리뷰 결과를 확인하고 후속 수정으로 이어갈 수 있도록 구성되어 있습니다.

code-review의 주요 특징

• 커밋된 변경 사항과 커밋되지 않은 변경 사항의 리뷰 범위를 지정할 수 있습니다.
• 발견된 문제를 Critical, Major, Minor 등 중요도에 따라 정리합니다.
• 각 문제의 파일 위치와 영향, 수정 방향을 함께 제공합니다.
• 리뷰 결과를 확인한 뒤 후속 코드 수정 작업으로 연결할 수 있습니다.

code-review를 사용할 때 주의할 점

• CodeRabbit CLI와 계정 인증이 필요합니다.
• CLI가 설치되어 있지 않으면 설치 명령을 실행할 수 있지만 로그인은 사용자가 완료해야 합니다.
• 인증 실패나 네트워크 오류가 발생해도 Codex 자체 리뷰로 자동 대체하지 않습니다.
• CodeRabbit의 검토 결과가 사람의 최종 코드 리뷰를 완전히 대신하지는 않습니다.

code-review는 언제 사용하면 좋을까요?

Pull Request를 만들기 전에 변경된 코드를 한 번 더 점검하고 싶을 때 유용합니다. 팀 리뷰 전에 반복적인 오류를 먼저 찾거나, 혼자 개발하면서 놓친 문제를 확인하는 셀프 리뷰 과정에 활용할 수 있습니다.

3. gh-address-comments, 

Pull Request 리뷰 의견을 코드에 반영하는 스킬

* 이미지 출처: OpenAI Plugins GitHub 저장소 – gh-address-comments 스킬

gh-address-comments는 GitHub Pull Request에 등록된 미해결 리뷰 스레드와 인라인 댓글을 확인하고, 사용자가 선택한 의견을 코드에 반영하도록 돕는 스킬입니다.

리뷰 댓글이 많으면 수정이 필요한 의견과 단순 설명을 구분하고, 관련 파일을 찾는 데 시간이 필요합니다. 이 스킬은 리뷰 의견을 파일이나 기능 영역별로 묶고 실제로 처리해야 할 항목을 정리합니다.

사용자가 모든 의견을 수정하라고 요청하지 않았다면, Codex는 처리할 항목을 먼저 보여주고 어떤 댓글을 반영할지 확인합니다.

어떤 플러그인에 포함되어 있나요?

* 이미지 출처: OpenAI Plugins GitHub 저장소 – CodeRabbit 플러그인 

gh-fix-ci와 동일하게 GitHub 플러그인에 포함되어 있습니다. GitHub 플러그인은 Pull Request 검토, 리뷰 의견 처리, CI 실패 분석처럼 GitHub에서 반복되는 개발 업무를 하나의 작업 흐름으로 연결합니다.

gh-address-comments의 주요 특징

• 현재 브랜치 또는 지정된 Pull Request의 리뷰 의견을 불러옵니다.
• 미해결 의견과 이미 처리된 의견, 중복 댓글을 구분합니다.
• 수정이 필요한 항목을 파일이나 기능 영역별로 묶어 정리합니다.
• 사용자가 선택한 의견만 코드에 반영하고 처리 결과를 요약합니다.

gh-address-comments를 사용할 때 주의할 점

• GitHub CLI 인증과 저장소 접근 권한이 필요합니다.
• 모든 리뷰 의견이 반드시 코드 수정으로 이어지는 것은 아닙니다.
• 의견끼리 충돌하거나 의미가 모호한 경우에는 사람의 판단이 필요합니다.
• 사용자의 명시적인 요청 없이 댓글 답변, 스레드 해결, 리뷰 제출을 자동으로 진행하지 않습니다.

gh-address-comments는 언제 사용하면 좋을까요?

Pull Request에 여러 개의 리뷰 댓글과 변경 요청이 등록된 경우 유용합니다. GitHub 화면과 코드 편집기를 오가며 의견을 하나씩 확인하는 시간을 줄이고, 선택한 리뷰 의견만 체계적으로 반영하고 싶을 때 활용할 수 있습니다.

4. frontend-testing-debugging, 

화면 테스트와 프런트엔드 오류 수정을 연결하는 스킬

* 이미지 출처: OpenAI Plugins GitHub 저장소 – frontend-testing-debugging 스킬  

frontend-testing-debugging은 브라우저로 접근할 수 있는 웹 앱의 화면과 사용자 동작을 테스트하고, UI 오류와 콘솔 문제를 분석하는 스킬입니다.

프런트엔드 오류는 코드만 읽어서는 찾기 어려운 경우가 많습니다. 버튼이 반응하지 않거나 화면 크기에 따라 레이아웃이 깨질 수 있습니다. 사용자 입력 이후 예상과 다른 결과가 나타나는 경우도 있습니다.

이 스킬은 Browser 플러그인을 사용할 수 있는지 먼저 확인합니다. Browser 플러그인을 이용할 수 있다면 이를 우선 사용하고, 사용할 수 없는 환경에서는 Playwright를 이용해 화면과 상호작용을 검증합니다.

어떤 플러그인에 포함되어 있나요?

* 이미지 출처: OpenAI Plugins GitHub 저장소 – Build Web Apps 플러그인 

OpenAI 공식 저장소의 Build Web Apps 플러그인에 포함되어 있습니다. Build Web Apps는 웹 앱 제작과 테스트, React 개발, UI 구성, Stripe 결제, Supabase 연동에 필요한 여러 스킬을 묶어 제공하는 플러그인입니다.

frontend-testing-debugging의 주요 특징

• 페이지 주소와 제목, 실제 콘텐츠가 정상적으로 표시되는지 확인합니다.
• 콘솔 오류와 프레임워크 오류 화면을 검사합니다.
• 버튼과 폼 등 주요 상호작용을 실행하고 상태 변화를 검증합니다.
• 데스크톱과 모바일 화면에서 레이아웃 문제를 확인합니다.

frontend-testing-debugging을 사용할 때 주의할 점

• 테스트할 웹 앱에 브라우저로 접근할 수 있어야 합니다.
• 로컬 프로젝트를 테스트한다면 개발 서버가 실행되어 있어야 합니다.
• Browser 플러그인을 사용할 수 있다면 일반 Playwright보다 우선 사용합니다.
• 빌드 성공만으로 화면이 정상 작동한다고 판단하지 않고 실제 렌더링을 검증해야 합니다.

frontend-testing-debugging은 언제 사용하면 좋을까요?

웹 앱의 UI를 만든 뒤 실제 화면과 상호작용을 검증할 때 유용합니다. 버튼이나 폼이 정상적으로 작동하지 않거나, 특정 화면 크기에서 레이아웃이 깨지는 문제를 재현하고 수정할 때 활용하기 좋습니다.

5. react-best-practices, 

React와 Next.js 성능을 점검하는 스킬

* 이미지 출처: OpenAI Plugins GitHub 저장소 – react-best-practices 스킬  

react-best-practices는 React와 Next.js 코드를 작성하거나 검토할 때 성능 최적화 기준을 적용하도록 돕는 스킬입니다.

이 스킬은 React 코드 스타일 전반을 검사하는 범용 가이드라기보다, 데이터 요청과 번들 크기, 렌더링, 재렌더링 등 성능에 영향을 주는 요소를 점검하는 데 초점이 맞춰져 있습니다.

어떤 플러그인에 포함되어 있나요?

* 이미지 출처: OpenAI Plugins GitHub 저장소 – Build Web Apps 플러그인

Build Web Apps 플러그인에 포함되어 있습니다. React와 Next.js의 신규 코드 작성, 기존 코드 검토, 리팩토링과 성능 개선 과정에서 참고하는 개발 지침으로 활용할 수 있습니다.

react-best-practices의 주요 특징

• 비동기 작업이 순차적으로 실행되는 워터폴 문제를 점검합니다.
• 번들 크기와 불필요한 코드 로딩을 줄이는 방식을 제안합니다.
• 서버와 클라이언트의 데이터 요청 및 렌더링 구조를 검토합니다.
• 불필요한 재렌더링과 JavaScript 성능 문제를 개선하는 기준을 제공합니다.

react-best-practices를 사용할 때 주의할 점

• 모든 규칙을 모든 프로젝트에 동일하게 적용할 필요는 없습니다.
• 현재 사용하는 React·Next.js 버전과 프로젝트 구조를 함께 고려해야 합니다.
• 제안된 최적화가 실제 성능 개선으로 이어지는지는 측정해야 합니다.
• 작은 프로젝트에 과도한 최적화를 적용하면 코드가 복잡해질 수 있습니다.

react-best-practices는 언제 사용하면 좋을까요?

React나 Next.js로 새로운 기능을 만들거나, 기존 프로젝트의 성능과 구조를 검토할 때 활용하기 좋습니다. 페이지 로딩 속도, 번들 크기, 데이터 요청, 불필요한 재렌더링 문제를 점검하거나 리팩토링할 때 사용할 수 있습니다.

Codex Skills를 사용할 때 주의해야 할 점

1. 하나의 스킬에는 하나의 업무만 넣는 것이 좋습니다

PR 리뷰, 배포, 디버깅, 로그 분석을 하나의 스킬에 모두 넣으면 실행 조건이 불명확해질 수 있습니다. 스킬의 역할을 작게 나누면 Codex가 필요한 상황에 맞는 스킬을 더 정확하게 선택할 수 있습니다.

2. 설명에는 실행 조건을 명확하게 적어야 합니다

Codex는 스킬의 이름과 설명을 먼저 확인한 뒤, 요청과 관련이 있다고 판단하면 전체 내용을 불러옵니다. 따라서 설명에는 무엇을 하는 스킬인지뿐 아니라 언제 사용해야 하는지도 함께 작성해야 합니다.

3. 처음부터 복잡한 스크립트를 추가할 필요는 없습니다

대부분의 스킬은 작업 지침만으로 시작할 수 있습니다. 정확한 결과가 필요하거나 외부 도구를 실행해야 하는 경우에만 스크립트를 추가하는 것이 좋습니다.

4. 자동 실행 범위를 확인해야 합니다

코드 수정, 테스트 실행, 배포 명령어처럼 실제 환경에 영향을 줄 수 있는 작업은 실행 범위를 미리 설정해야 합니다. 운영 환경과 연결된 명령어는 사람이 승인한 뒤 실행하도록 구성하는 것이 안전합니다.

AI 코딩을 위한 Codex 사용법을 더 알고싶다면

Codex Goal 사용법, 목표만 설정하면 끝까지 간다

Codex CLI 사용법, 설치부터 AI 에이전트 활용 노하우까지 한 번에

Claude Code vs Codex, 어떤 AI 코딩 에이전트가 더 나을까?