Claude Code Skills vs Codex Skills: 구조와 차이 완전 정리

 

Claude Code나 Codex 같은 AI 기반 개발 도구를 사용하다 보면 단순한 프롬프트만으로는 반복 작업이나 복잡한 흐름을 처리하기 어려운 순간이 온다. 이때 사용하는 개념이 바로 Skill(스킬)이다. 결론부터 말하면 Skill은 AI에게 특정 작업을 수행하는 방법을 정의해두고 재사용하는 구조이다. 단순한 프롬프트를 넘어, 일종의 “재사용 가능한 작업 단위”라고 볼 수 있다. 이 글에서는 Claude Skill과 Codex Skill의 개념, 구조, 동작 방식, 그리고 실제 활용 예시까지 정리한다.

 

Skill이란 무엇인가

Skill은 AI가 특정 작업을 수행할 때 사용하는 정의된 실행 단위이다. 간단히 표현하면 다음과 같다.

사용자 요청
  ↓
Skill 선택
  ↓
정의된 작업 실행
  ↓
결과 반환

 

즉, 매번 프롬프트로 동일한 작업을 설명하는 대신, Skill로 정의해두고 필요할 때 호출하는 방식이다.

 

왜 Skill이 필요한가

AI에게 동일한 작업을 반복적으로 요청할 때 다음 문제가 발생한다.

• 매번 프롬프트를 다시 작성해야 한다
• 작업 방식이 일관되지 않을 수 있다
• 복잡한 작업은 실수 가능성이 높다

Skill을 사용하면 다음과 같이 바뀐다.

프롬프트 반복 → Skill 호출

 

정리하면 다음과 같다.

• 재사용 가능
• 일관된 결과
• 복잡한 작업 캡슐화

 

Claude Skill 구조

Claude Code에서 Skill은 보통 .claude/skills 디렉토리에 정의된다. 구조는 다음과 같다.

.claude/
  skills/
    my-skill/
      skill.yaml
      prompt.md
      script.sh

 

각 파일의 역할은 다음과 같다.

파일	역할
skill.yaml	Skill 정의 (이름, 설명, 실행 조건)
prompt.md	AI에게 전달되는 프롬프트
script.sh	실제 실행 로직

 

Skill 동작 흐름

Claude에서 Skill이 실행되는 흐름은 다음과 같다.

사용자 입력
  ↓
Skill 선택 (자동 또는 명시)
  ↓
prompt.md 실행
  ↓
script 실행
  ↓
결과 반환

 

즉, Skill은 단순 프롬프트가 아니라 프롬프트 + 실행 로직의 조합이다.

 

Claude Skill 예시

1. skill.yaml

name: format-code
description: 코드 포맷팅 수행

2. prompt.md

다음 코드를 포맷팅하라

3. script.sh

#!/bin/bash
black .

 

사용 흐름은 다음과 같다.

사용자: 코드 정리해줘
  ↓
Claude → format-code Skill 선택
  ↓
black 실행

 

Codex Skill 구조

Codex에서도 Skill 개념은 유사하다. 핵심은 다음과 같다.

• 특정 작업을 정의
• 모델이 자동으로 선택
• 실행 로직 포함

구조는 다음과 같이 이해할 수 있다.

Skill
 ├─ 이름
 ├─ 설명
 ├─ 입력
 ├─ 실행 로직

 

Claude vs Codex Skill 차이

항목	Claude Skill	Codex Skill
정의 방식	파일 기반	API / 플랫폼 기반
실행 방식	로컬 스크립트 가능	모델 중심 실행
확장성	매우 높음	플랫폼 의존
활용	개발 자동화	코드 생성/보조

• Claude는 “자동화 도구”에 가깝고
• Codex는 “AI 기능 확장”에 가깝다

 

Skill을 사용하는 대표적인 경우

Skill은 다음과 같은 작업에 적합하다.

• 코드 포맷팅
• 테스트 실행
• 빌드 자동화
• 로그 분석
• 코드 리뷰
• API 호출 자동화

 

Hook과 Skill의 차이

구분	Hook	Skill
실행 방식	자동	필요 시 실행
목적	흐름 제어	작업 수행
예시	Bash 차단	코드 포맷팅

• Hook은 “언제 실행될지”
• Skill은 “무엇을 할지”를 정의한다

 

Skill은 단순 프롬프트를 넘어서 AI를 “작업 단위로 확장”하는 개념이다.

• 반복 작업 제거
• 일관성 확보
• 자동화 강화

이 세 가지를 동시에 해결할 수 있다. Claude Code에서는 Hook과 Skill을 함께 사용하면 더 강력해진다.

• Hook → 실행 흐름 제어
• Skill → 작업 자동화

결국 Skill은 AI를 단순한 도구가 아니라 자동화된 개발 파이프라인의 일부로 만드는 핵심 요소이다.

 

관련 포스팅

2026.05.05 - [AI/AI Tools] - Claude Code Hook 이해하기: 개념, 구조, 그리고 실전 자동화 예제

 

---

 

참고 자료

https://goddaehee.tistory.com/411

 

https://code.claude.com/docs/ko/skills

 

https://developers.openai.com/codex/skills