6
Codex 사용법 6강. Skill과 반복 작업 구조화
Lesson 06

반복되는 요청은
매번 다시 쓰지 말고
Skill로 구조화하는 편이 좋습니다.

같은 로그인/auth 작업을 여러 번 수행하면 요청 구조는 점점 비슷해집니다. 이때는 개별 Prompt를 계속 다듬는 것보다, 반복 workflow를 Skill로 묶는 편이 낫습니다.

기준 날짜 2026-04-13

이 가이드는 OpenAI Codex 제품, 정책, 표준 변경에 따라 이후 달라질 수 있습니다.

공통 예시 — 로그인 에러 메시지 사라지는 문제 (펼치기)
문제: 로그인 실패 시 에러 메시지가 화면에서 사라집니다.
범위: auth/LoginForm.tsx, auth/useLogin.ts, auth/LoginForm.test.tsx
제약: UI 문구 유지, API 스펙 유지, auth 범위 안에서만 수정, npm test -- auth로 검증합니다.
Repeated Requests

반복 요청이 계속 쌓이면

  • 매번 로그인 버그 수정 범위를 다시 적어야 합니다.
  • 테스트 추가 기준이 사람마다 달라질 수 있습니다.
  • PR 리뷰 포인트를 누락하기 쉽습니다.
  • 요청 편차가 커질수록 결과도 흔들립니다.
Skill

Skill로 바꾸면

  • 반복 작업을 재사용할 수 있습니다.
  • 요청 품질 편차가 줄어듭니다.
  • 팀 단위 표준화가 쉬워집니다.
  • 새로운 예시도 더 빠르게 적용할 수 있습니다.
Skill Candidates

로그인/auth 사례에서 먼저 구조화할 수 있는 작업

버그 수정 초안원인 파악, 범위 제한, 테스트 실행까지 한 묶음으로 재사용할 수 있습니다.
테스트 추가 보조실패 케이스 재현, 테스트 보강, 검증 명령 실행 흐름을 묶습니다.
PR 리뷰 포인트 정리범위 초과 수정, 회귀 위험, 테스트 누락을 체크하는 패턴을 구조화합니다.
Without Skill

Skill이 없을 때

로그인 실패 시 에러 메시지 문제를 다시 봐주세요.
범위는 auth 쪽만이고 테스트도 같이 확인해주세요.
리뷰 포인트도 정리해주세요.

이 정도 요청은 사람이 이해할 수는 있지만, 매번 조금씩 달라져 결과 편차가 생기기 쉽습니다.

With Skill

Skill이 있을 때

[$auth-bugfix]를 사용해
로그인 실패 시 에러 메시지가 사라지는 문제를 처리해주세요.
범위는 auth 관련 파일만 허용하고
npm test -- auth 결과와 리뷰 포인트까지 포함해주세요.

핵심 조건이 Skill 안에 들어가 있으므로 요청이 짧아지고 일관성은 올라갑니다.

Template Example

간단한 Skill 설명 템플릿

# Skill: auth-bugfix

목적
- auth 영역의 국소 버그를 범위 제한과 검증 명령을 포함해 처리합니다.

기본 규칙
- 범위는 auth 관련 파일로 제한합니다.
- UI 문구와 API 스펙은 유지합니다.
- npm test -- auth 를 실행합니다.

출력
- 원인 요약
- 수정 내용
- 테스트 결과
- 리뷰 시 볼 포인트
Skill Mechanics

Skill은 어디에 어떻게 저장되나요

Skill 파일은 위치에 따라 개인용과 팀 공유용으로 나뉩니다. 프로젝트 루트에 넣으면 저장소에 커밋해 팀 전체가 쓸 수 있습니다.

저장 위치
# 개인용
~/.agents/skills/auth-bugfix/
  ├── SKILL.md
  └── scripts/

# 팀 공유 (프로젝트 루트에 커밋)
.agents/skills/auth-bugfix/
  ├── SKILL.md
  └── scripts/
SKILL.md 구조
# Skill: auth-bugfix

## Purpose
auth 영역 버그를 범위 제한과
검증 명령을 포함해 처리합니다.

## Default Rules
- 범위: auth 관련 파일만
- UI 문구·API 스펙 유지
- npm test -- auth 실행

## Output Format
원인 요약 / 수정 내용 /
테스트 결과 / 리뷰 포인트
호출 방법프롬프트에서 $auth-bugfix처럼 달러 기호와 Skill 이름을 쓰면 해당 Skill이 적용됩니다.
처음 만들 때$skill-creator Skill을 쓰면 목적을 설명하는 것만으로 SKILL.md 초안을 자동으로 만들어 줍니다.
좋은 후보로그 분석, 릴리즈 노트, PR 리뷰 체크리스트, 마이그레이션 계획처럼 반복 구조가 명확한 작업이 Skill에 잘 맞습니다.
MCP — 외부 도구 연결

Codex에 외부 도구를 연결하는 방법

MCP(Model Context Protocol)는 브라우저, 디자인 툴, 에러 추적 서비스 같은 외부 도구를 Codex에 연결하는 표준 방식입니다. 서버를 등록해두면 Codex가 해당 도구에 접근하거나 정보를 가져올 수 있습니다.

CLI로 추가
codex mcp add context7 \
  -- npx -y @upstash/context7-mcp

# 활성 서버 확인
/mcp
config.toml로 고정
# .codex/config.toml
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp"]
Context7라이브러리 공식 문서를 최신 상태로 Codex에 제공합니다. 버전별 API 차이를 잘못 참조하는 문제를 줄여줍니다.
Playwright브라우저 자동화 도구입니다. UI 테스트 작성이나 화면 동작 확인이 필요할 때 씁니다.
Sentry에러 추적 서비스와 연결합니다. 실제 발생한 에러 로그를 컨텍스트로 넘겨 디버깅에 활용합니다.
주의 필요한 도구만 연결하세요. 모든 MCP 서버를 다 켜두면 불필요한 도구 목록이 컨텍스트를 차지해 응답 속도와 품질에 영향을 줄 수 있습니다.
Workshop

실습

실습 1

팀에서 자주 반복하는 Codex 요청 3개를 적고, 어떤 것이 Skill 후보인지 골라보세요.

실습 2

auth 버그 수정이나 테스트 추가 보조를 위한 간단한 Skill 설명 템플릿을 작성해보세요.

References

공식 문서