Codex CLI에 스킬 설치하는 방법

Codex skills는 SKILL.md 파일이 포함된 폴더로, Codex에게 변경 사항 검토, 기능 계획 수립 또는 그림 생성과 같은 특정 작업을 수행하는 방법을 가르칩니다. Codex CLI는 리포지토리의 .agents/skills/와 사용자용 ~/.agents/skills/에서 로컬 스킬을 불러옵니다. 각 스킬은 SKILL.md를 포함하는 자체 폴더를 가지고 있습니다. SkillGild에서 호스팅되는 스킬도 동일한 로컬 디스커버리 패턴을 사용하며, 보호된 기능을 위해 SkillGild MCP 연결을 호출하는 래퍼가 적용됩니다.

툴이 자신의 워크플로우를 Codex skills로 설치하는 실제 예시는 OpenSpec 가이드를 참조하세요: openspec init은 .agents/skills/에 여섯 개의 스킬을 작성합니다.

Codex에 로컬 스킬 추가하기

팀 워크플로우를 위한 프로젝트 폴더 또는 개인 설정을 위한 사용자 폴더 중 하나를 선택하세요. 스킬과 함께 배포되는 모든 스크립트, 참조 및 에셋은 보존해야 합니다. 예를 들면:

your-project/
  .agents/
    skills/
...

파일에는 이름(name), 설명(description) 및 실행 가능한 지침이 필요합니다:

---
name: review-brief
description: "코딩 전에 제품 브리프의 누락된 요구사항을 확인하세요."
...

Codex CLI에서는 /skills를 사용하거나 $를 입력하여 스킬을 선택합니다. Codex는 설명에서도 이를 선택할 수 있습니다. 현재 폴더 디스커버리와 지원되는 인터페이스에 대한 최신 정보는 공식 skills 문서를 확인하세요. 위의 예시는 로컬 스킬 시스템을 사용하며, SkillGild가 필요하지 않습니다.

Codex를 호스팅된 스킬에 연결하기

1. SkillGild CLI 설치 및 로그인

CLI 설치를 따라 진행하세요. 현재 Go 1.26 이상과 SkillGild 소스 체크아웃을 사용하며, 다음 명령어를 실행합니다:

skillgild login
skillgild status

브라우저에서 장치 코드를 승인하세요. SkillGild는 자격 증명을 운영 체제의 자격 증명 저장소에 보관합니다.

2. 로컬 MCP 서버 등록하기

절대 실행 경로를 찾으려면 macOS/Linux에서는 command -v skillgild을, Windows에서는 where.exe skillgild을 사용하세요. 이 경로를 대입합니다:

codex mcp add skillgild -- /absolute/path/to/skillgild mcp
codex mcp list

Codex CLI 세션에서 /mcp는 활성 서버를 보여줍니다. 이 명령은 로컬 stdio 브리지를 시작하므로, Codex의 MCP 설정에 SkillGild API 키를 붙여넣을 필요가 없습니다. 서버 관리에 대한 자세한 내용은 공식 Codex MCP 가이드를 참조하세요.

3. 실제 카탈로그 스킬용 래퍼 설치하기

프론트엔드 워크플로우의 경우:

skillgild install design-taste-frontend --agent codex

CLI는 ~/.agents/skills/design-taste-frontend/SKILL.md 파일을 작성합니다. 이 파일의 codex 프리셋은 해당 사용자 디렉토리를 선택합니다.

Left: the wrapper file at ~/.agents/skills/design-taste-frontend/SKILL.md. Right: codex mcp add and the codex mcp list check for the skillgild server.
Taste Skill 목록에는 워크플로우와 현재 접근 요구 사항이 설명되어 있습니다.

4. 프로젝트에서 워크플로우 호출하기

$design-taste-frontend를 사용하여 이 랜딩 페이지를 검토하세요. 대상 청중은 독립 컨설턴트입니다. 기존 경로와 브랜딩을 유지하고, 제안된 디자인 방향을 설명한 다음, 모바일 레이아웃을 구현하고 확인하세요.

hybrid SkillGild 스킬의 경우, Codex는 자체 모델과 함께 세션 가이드를 따르며 필요에 따라 SkillGild 서버 도구를 호출합니다. 프롬프트 스킬은 skillgild_run_skill을 통해 호스팅된 응답을 반환합니다. 래퍼를 설치한다고 해서 두 스킬의 비공개 구현체가 사용자의 컴퓨터로 복사되는 것은 아닙니다.

Task	Listing to inspect
프론트엔드 디자인 또는 랜딩 페이지 재디자인 (design skills guide)	Taste Skill
...
읽기 전에 각 리스팅의 요구 사항과 공개 스키마를 확인하세요. 비디오 및 플로팅 워크플로우는 로컬 렌더러나 라이브러리가 필요할 수 있습니다. catalog selection guide에서 이러한 호스팅된 워크플로우를 다루며, Claude Code라는 제목에도 불구하고 나열된 스킬들은 연결된 Codex 에이전트도 지원합니다.

Codex 스킬 설정 문제 해결

스킬이 누락되었다면, SKILL.md 파일과 설치 범위를 확인하세요. 변경 사항이 나타나지 않으면 Codex를 재시작하세요. 래퍼(wrapper)는 보이지만 호스팅된 호출에 실패하면, codex mcp list와 skillgild status를 각각 확인하세요: 스킬 검색과 서버 연결성은 서로 다른 확인 사항입니다.

서버가 반환한 접근 권한, 할당량 또는 입력 오류를 사용하여 다음 단계를 선택하세요. 래퍼를 재설치한다고 해서 월간 허용량이 초기화되지는 않습니다. SkillGild의 agent quickstart에서 오류 처리를 문서화했습니다.

이 가이드는 현재 공식 문서와 SkillGild CLI 소스에 기반을 두고 있습니다. 계정 승인 및 인증된 런타임 단계는 사용자의 연결이 필요합니다.

기타 CLI 및 코딩 에이전트

.claude/skills/의 경우 Claude Code 설치를, MCP 구성을 위한 Cursor 설정을, 또는 클라이언트를 비교하기 위해 Claude Code 설치 가이드를 사용하세요.

원래는 skillgild.dev에 게시되었습니다.