Skill이란 무엇인가?

Skill은 반복 작업을 일관되게 처리하도록 만드는 재사용 가능한 작업 매뉴얼이다.

 

Skill은 하나의 폴더이며 필수 파일은 SKILL.md이다. 필요에 따라 스크립트, 참고 문서, 템플릿도 함께 넣을 수 있다.

my-skill/
├── SKILL.md
├── scripts/       선택 사항
├── references/    선택 사항
├── assets/        선택 사항
└── agents/
    └── openai.yaml 선택 사항

 

 

Codex는 처음부터 모든 Skill 내용을 전부 읽지 않는다. 우선 각 Skill의 name과 description을 보고 관련 Skill을 고른 뒤, 필요한 경우 전체 SKILL.md를 읽는다. 따라서 description을 구체적으로 작성하는 것이 매우 중요하다.

SKILL.md 구조는 다음과 같다.

---
name: skill-name
description: 이 Skill을 언제 사용하고 언제 사용하지 않아야 하는지 설명
---

Codex가 따라야 할 구체적인 작업 절차

 

 

Skill은 어디에 만들어야 하는가?

 

1. 프로젝트 전용 Skill은 저장소 안에 만들어야 한다.

project/.agents/skills/

 

2. 개인적으로 모든 프로젝트에서 사용해야 할 Skill은 사용자 홈 폴더에 만든다.

$HOME/.agents/skills/

 

Skill 실행 방법

 

Codex CLI 또는 IDE에서 다음과 같이 명시적으로 실행할 수 있다.

$feature-clarifier
$react-standard-screen
$quality-gate

 

또는 /skills 명령으로 사용할 수 있는 skilld을 확인할 수 있다.

Skill을 직접 지정하지 않아도 프롬프트 내용이 description과 일치하면 Codex가 자동으로 선택할 수 있다.하지만 초기에는 잘못된 Skill이 실행되는 것을 막기 위해 명시적으로 $skill-name을 붙이는 방식을 권장한다.

 

Codex에서 Skill을 만들 때는 내장 Skill Creator를 사용할 수 있다.

Skill Creator는 어떤 일을 하는 Skill인지, 언제 실행할지, 스크립트가 필요한지를 질문하며 초안을 만들어 준다.

$skill-creator