Vintage appMaker의 Tech Blog

[codex cli] skills를 활용한 codex 기능추가 본문

Source code or Tip/생성AI

[codex cli] skills를 활용한 codex 기능추가

VintageappMaker 2026. 2. 11. 19:49

codex skill을 활용한 프롬프트

Skill 사용이유: 프롬프트를 파일로 만들고 그 안에 소스코드를 넣거나 특정 조건에 소스코드를 실행시키라는 지시어를 만들어도 외부프로그램을 호출하여 사용할 수 있다. 그러나 범용적인 부분에서 "프롬프트의 길이"가 커지게 되므로 효율적이지 못할 때가 있다.

1. Skill이란?

codex가 프롬프트를 분석 후, 프롬프트에 필요한 기능을 만들기 위해 내 PC에 존재하는 소스코드나 외부프로그램 실행하도록 등록하는 것이다.

2. 등록법

  • skills 폴더에 하부에 다음과 같은 구조로 파일을 만든다.
내가만든Skill폴더/
├── SKILL.md
└── scripts/
    └── 내가만든소스(.py)

  • 윈도우에서는 일반적으로 다음과 같은 위치에 존재한다.
    • C:\Users[사용자].codex\skills\
  • skill.md는 skill을 어떻게 사용해야 하는 지 요약정보를 가지고 있다. 아래와 같은 형식을 사용한다. 형식은 약간씩 다를 수 있다.

---
name: 
description: 
---

# 제목

## 실행 방법

## 출력 형식

## 스크립트 위치

3. 예제

시스템 정보를 보여주는 skill을 등록하고 사용한다. 아래의 내용을 등록한다.

  • skill.md
---
name: system-status
description: system_status.py를 실행해 CPU, 메모리, 디스크 사용률을 수집하고 요약한다. 사용자가 시스템 진단, 머신 상태, 리소스 사용률을 요청할 때 사용한다.
---

# 시스템 상태

## 실행 방법
- `scripts/system_status.py`를 Python으로 실행한다.
- stdout의 JSON 문자열을 파싱한다.

## 출력 형식
- JSON 키:
  - `cpu`: CPU 사용률(%)
  - `memory`: 메모리 사용률(%)
  - `storage`: 디스크 사용률(%) (루트 파일시스템)
- JSON을 읽은 뒤 핵심 지표를 자연어로 요약한다.

## 스크립트 위치
- `scripts/system_status.py`

  • scripts/system_status.py
# system_status.py
import psutil
import json

def run():
    status = {
        "cpu": psutil.cpu_percent(),
        "memory": psutil.virtual_memory().percent,
        "storage": psutil.disk_usage('/').percent
    }
    print(json.dumps(status)) # CLI는 JSON 출력을 선호합니다.

if __name__ == "__main__":
    run()

skill을 등록한 후, codex를 실행 또는 재실행한다.

4. 결과

  • 프롬프트로 내 PC의 시스템 정보를 보여줘를 요청

  • 프롬프트 분석 후, skill 호출 준비

  • skill 호출된 결과

 

 

systeminfo.zip
0.00MB

Comments