OpenAI Skills: 한 번 작성하면 모든 AI 에이전트에서 작동한다

OpenAI Skills

“이 코드를 Cursor에서 돌려봤더니 잘 되는데, Claude Code에서는 어캐 하지?”

매번 다른 AI 코딩 도구를 쓸 때마다 같은 컨텍스트를 다시 설명하고, 같은 워크플로우를 다시 정의하고… Agent Skills는 이 문제를 근본적으로 해결합니다.

한 번 작성하면, 어디서든 작동합니다. OpenAI가 공개한 Skills 카탈로그는 이 오픈 표준을 보여주는 완벽한 예시입니다.

Agent Skills란?

Agent Skills는 AI 에이전트가 발견하고 사용할 수 있는 폴더 형태의 지식 패키지입니다:

지침 (Instructions) — 무엇을 해야 하는지
스크립트 (Scripts) — 어떻게 해야 하는지
리소스 (Resources) — 필요한 참고 자료

에이전트가 “이 Figma 디자인을 코드로 구현해줘”라는 요청을 받으면, Figma 스킬을 로드해서 올바른 워크플로우를 따릅니다. 매번 처음부터 배우는 게 아니라, 이미 준비된 전문성을 사용하는 거죠.

왜 Agent Skills가 필요한가?

AI 에이전트는 점점 더 똑똑해지지만, 실제 작업에 필요한 컨텍스트가 부족합니다.

회사마다 다른 코드 컨벤션
팀마다 다른 배포 프로세스
프로젝트마다 다른 보안 요구사항

이걸 매번 프롬프트에 설명하는 건 비효율적입니다. Skills는 이런 지식을 재사용 가능한 패키지로 만듭니다.

세 가지 이점

대상	이점
스킬 작성자	한 번 만들면 여러 에이전트 제품에서 사용 가능
호환 에이전트	사용자가 즉시 새로운 기능을 사용할 수 있음
팀/기업	조직 지식을 버전 관리되는 패키지로 캡처

OpenAI Skills 카탈로그: 35개 전문 스킬

OpenAI가 공개한 저장소는 3가지 카테고리로 구성되어 있습니다:

시스템 스킬 (자동 설치)

모든 Codex에 자동으로 설치되는 필수 스킬:

스킬	기능
`openai-docs`	OpenAI 문서 참조
`skill-creator`	새 스킬 생성 도우미
`skill-installer`	스킬 설치 관리자

큐레이션된 스킬 (35개)

검증된 고품질 스킬들:

개발 & 배포:

vercel-deploy, netlify-deploy, cloudflare-deploy, render-deploy
aspnet-core, winui-app
develop-web-game

디자인 & UI:

figma-implement-design — Figma 노드를 프로덕션 코드로 변환
figma — 기본 Figma 통합
screenshot — 스크린샷 캡처

GitHub 통합:

gh-address-comments — PR 리뷰 댓글 처리
gh-fix-ci — CI 실패 수정

Notion 워크플로우:

notion-knowledge-capture — 지식 캡처
notion-meeting-intelligence — 회의 인텔리전스
notion-research-documentation — 연구 문서화
notion-spec-to-implementation — 스펙 → 구현

AI 멀티모달:

imagegen — 이미지 생성
sora — 비디오 생성
speech — 음성 합성
transcribe — 음성 변환

기타:

jupyter-notebook, linear, sentry, slides, spreadsheet, pdf, doc

보안 스킬

security-best-practices — 보안 모범 사례
security-ownership-map — 소유권 매핑
security-threat-model — 위협 모델링

스킬 예시: Figma 디자인 구현

figma-implement-design 스킬이 어떻게 작동하는지 살펴보겠습니다:

---
name: "figma-implement-design"
description: "Translate Figma nodes into production-ready code..."
---

# Step 1: Get Node ID
URL에서 file key와 node ID 추출

# Step 2: Fetch Design Context
get_design_context()로 레이아웃, 타이포그래피, 색상 정보 획득

# Step 3: Generate Code
프로젝트 컨벤션에 맞게 코드 생성

사용자는 Figma URL만 제공하면 됩니다. 에이전트가 자동으로:

Figma MCP 서버에 연결
디자인 토큰과 레이아웃 정보 추출
프로덕션 레디 코드 생성

설치 및 사용법

Codex에서 스킬 설치

# 큐레이션된 스킬 설치
$skill-installer gh-address-comments

# 실험적 스킬 설치
$skill-installer install the create-plan skill from the .experimental folder

# GitHub URL로 설치
$skill-installer install https://github.com/openai/skills/tree/main/skills/.curated/figma-implement-design

설치 후 Codex를 재시작하면 새 스킬이 로드됩니다.

30개 이상의 도구가 이미 지원

Agent Skills는 단순한 OpenAI 전용 포맷이 아닙니다. 오픈 표준입니다:

도구	상태
OpenAI Codex	✅ 원천
Claude Code	✅ 공식 지원
Cursor	✅ 공식 지원
VS Code Copilot	✅ 공식 지원
GitHub Copilot	✅ 공식 지원
Gemini CLI	✅ 공식 지원
JetBrains Junie	✅ 공식 지원
OpenCode	✅ 공식 지원
Roo Code	✅ 공식 지원
Goose	✅ 공식 지원
…	총 30개 이상

Anthropic이 처음 개발하고 오픈 표준으로 공개했습니다. 이제 주요 AI 코딩 도구 대부분이 이 형식을 지원합니다.

직접 스킬 만들기

스킬은 단순한 폴더 구조입니다:

my-skill/
├── SKILL.md          # 필수: 지침과 워크플로우
├── scripts/          # 선택: 실행 스크립트
├── resources/        # 선택: 참고 자료
└── LICENSE.txt       # 선택: 라이선스

SKILL.md의 기본 구조:

---
name: my-skill
description: 무엇을 하는 스킬인지
metadata:
  short-description: 한 줄 요약
---

# 지침
에이전트가 따라야 할 워크플로우...

# 참고
필요한 컨텍스트...

Codex에서는 skill-creator 스킬이 이 과정을 도와줍니다.

Agent Skills가 가능하게 하는 것

도메인 전문성 법적 검토 프로세스부터 데이터 분석 파이프라인까지, 전문 지식을 재사용 가능한 지침으로 패키징

새로운 기능 프레젠테이션 생성, MCP 서버 구축, 데이터셋 분석 등 에이전트에 새 능력 부여

반복 가능한 워크플로우 다단계 작업을 일관되고 감사 가능한 프로세스로 변환

상호 운용성 같은 스킬을 다른 에이전트 제품에서 재사용

마치며: 에이전트의 “앱 스토어” 시대

스마트폰이 앱 스토어 없이는 완전하지 않은 것처럼, AI 에이전트도 스킬 없이는 완전하지 않습니다.

OpenAI Skills 카탈로그는 이 새로운 생태계의 시작점입니다. 35개의 검증된 스킬, 명확한 표준, 그리고 30개 이상의 도구 지원.

더 이상 “Cursor에서는 이렇게, Claude Code에서는 저렇게” 고민할 필요가 없습니다. 한 번 작성하면, 어디서든 작동합니다.

🔗 관련 정보

GitHub: https://github.com/openai/skills
공식 문서: https://developers.openai.com/codex/skills
Agent Skills 표준: https://agentskills.io
스킬 만들기: https://developers.openai.com/codex/skills/create-skill