Skill 이란?

LLM Wiki 가 가진 “목차 → 방대한 지식” 형태로 에이전트 컨텍스트를 경제적으로 쓰면서도 전문적인 작업에 필요한 모든 레퍼런스를 효과적으로 주입하는 데이터 정리 방법

에이전트가 알아서 관리하는 레퍼런스를 “지식 레퍼런스”라는 방대한 목표가 아니라, 단일 작업 유형에 적용한 것!

왜 만드는가?

• 자동화

  ⇒ 기본기인데 관련된 AI 동작이 성숙하지 않았다 → 복붙조차 귀찮다 → / 만 쓰자

• 지능화

  ⇒ 작업을 해야 하는데 덩어리가 너무 크다 → 여러 사례가 이미 있다 → 약어로 만들자

언제 남의 것을 가져다 쓰면 좋을까?

• 잘 알려진 서비스에 대한 검증된 스킬
• 노하우가 높은 특정 집단의 니즈와 선호를 담은 스킬이 나의 감성(업무적, 기술적 취향)과 맞을 때

언제 “내가” 만들면 좋을까?

• 내 반복적 작업 니즈가 잘 알려진 범용 시나리오와 다를 때 (나는 왜 다르게 작업하고 싶을까? → 잘 몰라서인 경우는 잘 알아보고 대중성을 따르면 더 효과적일 수 있다.)
  • 같은 워크플로를 3번 이상 반복한다 (커밋 메시지 규칙, Notion export, /goal 설계 등)
  • 여러 사람·여러 에이전트가 같은 규칙을 써야 한다.
• 나만의 취향과 선택에 따른 AI 제어 시나리오가 명확하게 정착할 때
  • 출력 형식이 고정되어야 한다 (4섹션 /goal 템플릿, 리포트 구조)
  • 콘텐츠가 길지만, 에이전트에게는 행동 원칙만 필요하다 (배경·레퍼런스는 README/별도 문서)
• 시행착오 끝에 작업 순서가 정착했을 때 → Workflow 로 가는 임계구간에 돌입
  • 실패 패턴이 예측 가능하다 (API 필드명, ID 형식, hang, 권한)

어떤 형태로 만들면 좋을까?

AI 스킬·도구 구조 설계 가이드 (공통)

• Claude 스킬 제작스킬 없고, 가이드만 있음

  skill-name/
  ├── SKILL.md          ← 항상 짧게. 핵심 절차 + "자세한 건 아래 참조"
  ├── reference.md      ← Claude가 필요하다고 판단할 때만 Read로 열어봄
  ├── examples.md       ← 마찬가지로 필요시에만
  └── scripts/          ← 본문에 코드를 쓰지 말고 실행 파일로 둠
  

• Cursor /create-skill (Claude 와 동일한 구조)

  skill-name/
  ├── SKILL.md          # 필수
  ├── reference.md      # 선택 (긴 API/레퍼런스)
  ├── examples.md       # 선택
  └── scripts/          # 선택 (취약·반복 작업)
  

• Codex $skill-creator

  skill-name/
  ├── SKILL.md
  └── references/
      ├── auth.md
      ├── endpoints.md
      └── error-handling.md
  

본문만 있어도 됨 전체 구조를 갖추지 않아도 됨 Codex 에서도 같은 구조여도 됨

Skill 만들어 보기

아무 제어 없이, 제작 스킬 호출도 없이 스킬 제작 요청하기