{"id":"codex-skills","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/codex-skills","title":"반복 작업을 이름 하나로 부르는 스킬로 만들기 (Codex 스킬)","summary":"자주 하는 작업의 순서를 매번 설명하지 않아도, $이름 한 번으로 같은 절차를 그대로 실행합니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"writing","label":"글쓰기·요약"},{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Codex CLI"],"whenToUse":"만들기 도우미로 초안을 만들거나 SKILL.md를 직접 써서 스킬 폴더에 둡니다. 목록에 보이는지 확인한 뒤 $이름으로 불러 실행합니다.","body":"## 준비\n\n- Codex CLI 또는 IDE 확장\n- 스킬로 만들 반복 작업 하나\n\n### 1. 만들기 도우미로 초안 생성\n\nCodex에서 내장 `$skill-creator`를 부르고 작업을 설명합니다. 도우미가 하는 일, 실행 시점, 스크립트 필요 여부를 묻습니다. 기본은 지시문만 있는 스킬입니다.\n\n```prompt\n$skill-creator [반복할 작업]\n```\n\n폴더에 `SKILL.md`가 생기면 초안이 만들어진 것입니다.\n\n### 2. 직접 만들 때는 SKILL.md 작성\n\n도우미 없이 만들려면 저장소의 `.agents/skills/<skill-name>/SKILL.md`를 씁니다. 머리말에 name과 description은 꼭 있어야 합니다. 설명 앞부분에 주 용도와 부를 낱말, 쓰지 말아야 할 경우를 함께 적습니다.\n\n```bash\n---\nname: <skill-name>\ndescription: Explain exactly when this skill should and should not trigger.\n---\n\nSkill instructions for ChatGPT or Codex to follow.\n```\n\n### 3. 둘 위치 정하기\n\n저장소 전체용은 `$REPO_ROOT/.agents/skills`, 한 하위 폴더용은 그 폴더의 `.agents/skills`, 모든 저장소 공통은 `$HOME/.agents/skills`에 둡니다.\n\n### 4. 목록에서 확인\n\nCodex에서 `/skills`를 실행합니다. 변경은 자동으로 감지되고, 목록에 새 스킬이 안 보이면 Codex를 다시 시작합니다.\n\n```bash\n/skills\n```\n\n### 5. 이름으로 불러 실행\n\n프롬프트에 `$`와 스킬 이름을 넣어 직접 부릅니다. 설명과 맞는 작업을 말하면 Codex가 스스로 고르기도 합니다.\n\n```prompt\n$[스킬 이름]\n```\n\n결과가 스킬에 적은 순서와 형식을 따르면 됩니다.\n\n## 주의\n\n- 스킬이 많으면 처음 목록의 설명이 줄거나 일부 스킬이 빠질 수 있고, 이때 경고가 나옵니다. 주 용도와 부를 낱말은 설명 앞쪽에 둡니다.\n- 같은 name의 스킬 둘은 합쳐지지 않고, 둘 다 선택 목록에 보일 수 있습니다.\n- 스킬 하나에는 일 하나만 맡깁니다. 스크립트는 정해진 결과나 외부 도구가 필요할 때만 넣습니다.\n- 지우지 않고 끄려면 `~/.codex/config.toml`의 `[[skills.config]]`에 path와 `enabled = false`를 적고 Codex를 다시 시작합니다.\n- `agents/openai.yaml`에서 `policy.allow_implicit_invocation = false`이면 자동 선택이 꺼지고 `$이름` 호출만 동작합니다.","prerequisites":["Codex CLI 또는 IDE 확장","스킬로 만들 반복 작업 하나"],"inputs":[{"name":"task","label":"반복 작업","description":"스킬로 만들 작업과 실행 시점","example":"PR을 올리기 전 변경 내역으로 릴리스 노트 초안 작성","required":true},{"name":"skill_name","label":"스킬 이름","description":"SKILL.md의 name 값","example":"release-notes","required":true}],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"ai","title":"만들기 도우미로 초안 생성","body":"Codex에서 내장 $skill-creator 호출 후 작업 설명. 도우미가 하는 일·실행 시점·스크립트 필요 여부를 질문. 기본은 지시문만 있는 스킬.","prompt":"$skill-creator {{task}}","expected":"SKILL.md가 든 스킬 폴더 초안","check":"폴더에 SKILL.md가 생기면 성공","tool":"Codex CLI"},{"n":2,"kind":"command","title":"직접 만들 때는 SKILL.md 작성","body":"도우미 대신 직접 만들려면 저장소의 .agents/skills/{{skill_name}}/SKILL.md 작성. 머리말에 name·description 필수. 설명 앞부분에 주 용도와 부를 낱말, 쓰지 말아야 할 경우도 함께.","prompt":"---\nname: {{skill_name}}\ndescription: Explain exactly when this skill should and should not trigger.\n---\n\nSkill instructions for ChatGPT or Codex to follow.","expected":".agents/skills/{{skill_name}}/SKILL.md","check":"머리말에 name과 description이 있으면 성공","tool":"Codex CLI"},{"n":3,"kind":"human","title":"둘 위치 정하기","body":"저장소 전체용은 $REPO_ROOT/.agents/skills, 한 하위 폴더용은 그 폴더의 .agents/skills, 모든 저장소 공통은 $HOME/.agents/skills.","expected":"용도에 맞는 위치의 스킬 폴더","check":"다음 단계 목록에 스킬이 보이면 성공","tool":"Codex CLI"},{"n":4,"kind":"command","title":"목록에서 확인","body":"Codex에서 /skills 실행. 변경은 자동 감지, 안 보이면 Codex 다시 시작.","prompt":"/skills","expected":"스킬 목록에 새 스킬","check":"{{skill_name}}이 목록에 보이면 성공","tool":"Codex CLI"},{"n":5,"kind":"ai","title":"이름으로 불러 실행","body":"프롬프트에 $와 스킬 이름을 넣어 직접 호출. 설명과 맞는 작업을 말하면 Codex가 스스로 고르기도 함.","prompt":"${{skill_name}}","expected":"SKILL.md의 지시대로 진행된 작업","check":"결과가 스킬에 적은 순서·형식을 따르면 성공","tool":"Codex CLI"}],"pitfalls":["스킬이 많으면 처음 목록의 설명이 줄거나 일부 스킬이 빠질 수 있음(경고 표시). 주 용도와 부를 낱말은 설명 앞쪽에","같은 name의 스킬 둘은 합쳐지지 않고 둘 다 선택 목록에 보일 수 있음","스킬 하나에 일 하나. 정해진 결과나 외부 도구가 필요할 때만 스크립트","지우지 않고 끄려면 ~/.codex/config.toml의 [[skills.config]]에 path와 enabled = false, 바꾼 뒤 Codex 다시 시작","agents/openai.yaml에서 policy.allow_implicit_invocation = false면 자동 선택은 꺼지고 $이름 호출만 동작"],"sources":[{"title":"Build Skills","url":"https://learn.chatgpt.com/docs/build-skills.md"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":29,"likes":0}