에이전트 스킬 vs SDK — 1인 운영자의 솔직한 답

에이전트 스킬 vs SDK — 스킬 46개 중 42개는 SDK가 필요 없었다

결론부터 말한다. 1인 운영자 대부분은 스킬로 충분하다. SDK가 필요한 경우는 명확하고 소수다. 필자는 Claude Code에서 스킬 46개를 운영 중이고, 그중 SDK로 다시 만들 이유가 있는 건 4개뿐이다. Hacker News에서도 “Agent Skills are replacing SDK” 류 토론이 4월 들어 전면에 올랐고(필자가 매일 돌리는 trend-scout 수집기에 2026-04-18 Top 10 핫토픽으로 집계됐다), 이 비대칭을 본 사람이 늘고 있다는 신호다. 단, 스킬에는 대가가 있다. Anthropic 생태계 lock-in이다. 이 글은 그 대가를 솔직히 다룬다.

용어 먼저

한 줄 정의:

  • 에이전트 스킬(Agent Skill): .claude/skills/ 디렉토리에 마크다운 파일을 두면 Claude가 상황에 맞게 자동 로드하는 지시문 묶음
  • Agent SDK: Python 또는 TypeScript로 Claude를 도구 사용 루프로 프로그래밍하는 개발용 라이브러리. 도구 사용 루프란 Claude가 도구(파일 읽기, 검색, API 호출 등)를 호출하고 결과를 받아 다음 행동을 결정하는 반복 구조다.

스킬은 “이런 상황에 이렇게 해라”를 글로 적는다. SDK는 같은 걸 코드로 짠다.

한눈에 비교 + 선택 기준

상황 권장
본인 또는 소수 팀이 쓴다 스킬
세션이 끝나면 잊어도 된다 스킬
Claude Code 안에서 실행된다 스킬
자연어로 호출된다 스킬
외부 사용자에게 서비스한다 SDK
스케줄러로 정기 실행된다 SDK
DB/큐로 상태를 오래 유지한다 SDK
엔터프라이즈 권한·감사 로그 필요 SDK
OpenAI·Gemini와 혼용한다 SDK

왼쪽 4가지 조건에 다 해당하면 스킬로 충분하다. 오른쪽 5가지 중 하나라도 YES면 SDK가 필요하다.

필자가 운영 중인 스킬 하나 — trend-mine

추상적으로 말하지 않겠다. 구체 스킬 하나를 공개한다.

trend-mine — 외부 수집기(trend-scout)가 매일 HN·Reddit·네이버 블로그 등에서 긁어 저장한 원본 트렌드 파일을 읽어, 블로그·스레드·SaaS 기회 후보를 뽑아주는 스킬이다. 수집은 별도 크론(또는 수동 트리거)으로 돌리고, 분석은 스킬이 맡는다.

~/.claude/skills/trend-mine/
├── SKILL.md          # 지시문 (200줄)
└── references/       # 참고 자료 (SEO 체크리스트 등)

동작:

  1. /trend-mine 한 줄로 호출
  2. Claude가 trend-scout이 저장해둔 최신 트렌드 파일을 읽음
  3. 클러스터링 → Top 10 핫토픽 표 생성
  4. 블로그·스레드·SaaS 기회 후보 각각 5개씩
  5. 각 후보에 판정(🟢 proceed / 🟡 revisit / 🔴 pass)

결과물 예시: 바로 이 글 주제도 trend-mine이 어제 뽑아준 목록 중 하나다. 4-18 리뷰에서 “에이전트 스킬이 SDK를 대체?”가 🟢 proceed로 찍혔고, 오늘 이 글을 쓰고 있다.

같은 걸 SDK로 만들면: Python 프로젝트 생성 + 스케줄러 설정 + Claude API 호출 래퍼 + 프롬프트 템플릿 + 결과 파싱 + 저장 로직. 수백 줄. 디버깅 주기 길다. 매번 배포해야 한다.

스킬로 만드니까: 마크다운 200줄. 수정하면 다음 호출부터 바로 반영. 다른 프로젝트에 복사하려면 디렉토리 하나 옮기면 끝.

이런 비대칭이 필자 기준 스킬 46개 중 42개에 해당한다.

필자의 스킬 분포 — 42개는 스킬로 충분, 4개는 SDK 필요

SDK가 진짜 필요한 경우

반면 SDK 없이는 안 되는 사례도 있다.

1. 외부 사용자 웹서비스

“AI 챗봇을 회사 홈페이지에 붙인다”면 SDK가 필요하다. 스킬은 Claude Code를 띄우고 필자가 호출해야 실행된다. 수천 명 사용자가 접속할 환경엔 못 쓴다.

2. 스케줄러 정기 실행

“매일 새벽 3시 뉴스 수집”이면 SDK. 스킬은 트리거가 필자 호출이지, 크론이 아니다.

3. 엔터프라이즈 시스템 통합

권한·감사 로그·컴플라이언스가 엮이는 ERP/CRM 연동은 SDK 코드로 써야 안전하다. MCP로 일부 가능하지만, 비즈니스 로직은 코드가 검증 가능하다. MCP 구조는 MCP란 무엇인가에서 설명했다.

4. 비 Claude 환경

OpenAI·Gemini·오픈소스 모델과 혼용하거나 Claude 없는 환경에서 돌려야 하면 SDK 또는 벤더 중립 프레임워크가 필요하다.

대가 — Anthropic 생태계 Lock-in

스킬의 가장 큰 대가는 벤더 종속성이다. 솔직히 적는다.

  • 현재 스킬 형식(.claude/skills/ + SKILL.md)은 Anthropic 전용이다. 표준이 아니다.
  • Anthropic이 스킬 구조를 바꾸면 필자의 46개 스킬은 마이그레이션 대상이다.
  • 다른 AI 도구(Cursor 등)가 스킬 형식을 채택하더라도 호환 보장은 없다.
  • MCP가 벤더 중립 표준으로 확산 중인데, 스킬은 아직 그 궤도에 없다.

필자는 이 lock-in을 감수할 가치가 있다고 판단한다. 이유: (1) Claude Code 외부에선 필자가 작업 안 함, (2) 마크다운이라 타 도구 이식 비용이 낮음, (3) 교체 비용보다 현재 생산성 이득이 큼. 그러나 이 판단은 각자 환경에 따라 달라진다. OpenAI 중심 개발자라면 같은 선택이 안 나올 수 있다.

왜 2026년에 스킬이 주목받나

첫째, 진입 장벽이 낮다. 프롬프트 작성 수준이면 스킬을 만든다. SDK는 개발자만 쓴다.

둘째 — 이게 결정적인데 — 공유가 마크다운 파일 하나로 끝난다. GitHub에 디렉토리 올리면 다른 사람이 복사해서 바로 쓴다. SDK는 패키지 배포·버전 호환성·설치 가이드까지 딸려온다.

셋째는 수정 주기. 파일 한 줄 고치면 다음 호출에 반영된다. SDK는 배포 사이클이 끼어든다.

단, 이 장점들은 작은 범위의 개인·팀 내부에서만 성립한다. 범위가 커지면 SDK의 엄격함이 필요해진다.

자주 묻는 질문

에이전트 스킬과 SDK는 뭐가 다른가?

스킬은 .claude/skills/ 디렉토리에 마크다운 파일을 두면 Claude가 상황에 맞게 자동 로드하는 지시문이다. SDK는 Python/TypeScript로 프로그램을 짜서 Claude를 도구 사용 루프로 돌리는 라이브러리다. 한쪽은 지시, 한쪽은 코드다.

1인 운영자는 둘 중 뭘 써야 하나?

대부분 스킬로 충분하다. 필자가 운영하는 스킬 46개 중 42개는 SDK로 만들 이유가 없었다. SDK가 필요한 경우는 외부 사용자 서비스·정기 배치·엔터프라이즈 통합 3가지로 축약된다.

스킬은 Claude에 종속되나?

그렇다. 현재 스킬 시스템은 Anthropic 제품(Claude Code, Claude Desktop) 전용이다. OpenAI·Gemini 환경에서 돌리려면 SDK나 별도 프레임워크가 필요하다. 이 lock-in을 감수할 가치가 있는지는 각자 판단해야 한다.

관련 시리즈

지금 해볼 것

.claude/skills/my-skill/SKILL.md 파일 하나 만들어 오늘 반복한 작업 과정을 글로 적어봐라. 15분이면 다음 세션부터 Claude가 자동으로 쓴다. SDK가 필요한지는 그다음에 판단해도 늦지 않다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

[알고리즘] Suffix Tree

이미지
Suffix tree는 문자열의 모든 접미사들을 표현하는 trie 모양의 자료 구조이다. prefix tree라 불리는 trie가 근간이 되는 자료구조인듯 한데 두 자료구조의 차이는 banana라는 단어가 있을 때 trie는 banana라는 단어만 저장을 하지만 suffix tree는 banana, anana, nana, ana, na, a 와 같이 banana라는 단어에서 나올 수 있는 모든 경우의 수를 다 저장한다는 것이다. 쓸데없이 모든 경우를 저장하는 이유는 문자열에 대한 검색을 할 때 필요하기 때문이다. Trie 자료구조 같은 경우에는 ban, ba와 같은 일부분의 단어로 banana라는 완전한 단어를 찾을 수 있지만 nan, ana와 같은 단어로는 banana를 찾을 수 없다. 이러한 문제를 해결하기위해 trie를 개선시킨 것이 suffix tree인듯 하다.  Suffix trie는 trie에 모든 suffix들을 저장한 구조를 의미한다. 아래 그림은 abaaba라는 문자열 T를 suffix tree에 저장하는 예시이다. suffix tree나 suffix trie에 문자열을 저장할 때는 문자열의 끝에 $를 붙이는데 그 이유는 정확히 모르겠다... 아마 문자열의 끝을 알리기 위한 용도인 것 같다. Suffix Trie의 형태  위 그림의 왼쪽과 같은 모양이 suffix trie이다. 여기서 자식 노드가 1개 뿐인 것들을 합치면 오른쪽과 같은 모양이 되는데 저러한 형태의 자료구조를 suffix tree라 한다. Suffix Tree  이 suffix tree는 문자열의 길이만큼의 leaf node를 갖는다  위 그림에서 오른쪽 그림은 tree의 edge label을 (offset, length)의 형태로 T를 나타낸 것이다. Suffix tree의 label  각 노드의 label은 root로부터 node로 연결된 edge의 label과 ...
자세한 내용 보기

[기타IT] php설치

이미지
 이번에는 php 설치하는 법에 대해 알아보겠습니다. 저는 개발할 때 node.js를 사용 하지만 이번에 프로젝트하는데 필요한 xibo가 php기반이라 설치하게 되었습니다. php란?  php(약칭 : Hypertext Preprocessor)는 프로그래밍 언어의 일종으로 동적 웹 페이지를 만들기 위해 설계되었습니다. php는 일반적으로 혼자 설치되지 않고 apache와 MySql과 함께 설치되는 것이 일반적입니다.  php는 apache를 통해 브라우저로 정보를 전송하고 MySql을 이용해 사용자의 정보를 저장하기 때문에 일반적으로 함께 사용되고 설치됩니다. 이를 APM이라 하는데 Window에 설치하는 APM을 WAPM이라 합니다. 이걸 각각 설치 할 수도 있지만 난이도가 있기 때문에 Bitnami를 이용해 한번에 설치해 보도록 하겠습니다. php설치 먼저 https://bitnami.com/stack/wamp 에 접속하여 설치파일을 다운로드 받습니다.  다운로드가 완료되면 설치파일을 실행합니다. 다른 구성요소들은 굳이 필요하지 않으니 체크박스를 해제해줍니다. php에서 쓰는 MySql의 root사용자 비밀번호를 설정해주는 화면입니다. 6자리 이상의 비밀번호를 입력하시면 됩니다. 설치가 되고 있는 화면입니다.  설치가 완료되고 브라우저 주소창에 localhost를 쳤을 때 다음과 같은 화면이 출력되면 제대로 설치가 된것입니다.
자세한 내용 보기

[Digital Signage] Xibo 설치

이미지
 이번에는 Digital Signage용 오픈소스 OS인 Xibo를 설치하는 방법에 대해 알아보겠습니다. Xibo는 php기반이기 때문이 php가 설치되어 있어야 합니다. php 설치가 필요하신 분들은  http://cd4761.blogspot.kr/2016/02/it-php.html 로 가셔서 설치를 하신다음 진행해주시기 바랍니다.   http://xibo.org.uk/  에 접속해서 아래 그림과 같이 표시된 것들을 다운로드 받습니다.  먼저 CMS를 설치해 보도록 하겠습니다. CMS CMS란?  CMS는 Content Management System의 약자로 말그대로 Digital Signage를 통해 보여줄 컨텐츠들을 관리하는 시스템이라 보시면 됩니다. CMS는 PHP/ MySQL 웹 어플리케이션 이며 Apache, nginx 그리고 Microsoft IIS에서 작동 합니다. CMS설치 다운로드 받은 CMS파일을 압축 푼 다음 C:\Bitnami\wampstack-5.5.31-0\apache2\htdocs에 다음과 같이 위치 시켜줍니다. Xibo폴더 내부는 다음과 같습니다. 그 다음 브라우저에 localhost/Xibo를 입력하면 다음과 같은 화면이 출력됩니다. 하지만 사진을 보시면 각 항목이 체크 표시가 된 경우도 있고 x표시가 된 경우도 있을 것 입니다. 그럴 경우 C:\Bitnami\wampstack-5.5.31-0\php 폴더에 있는 php.ini 파일을 열면  위와 같은 부분이 있을 것입니다. 저는 Fileinfo와 SOAP Extension에 문제가 있다고 되어있는데 이럴경우 저 부분에 extension=php_fileinfo.dll과 extension=php_soap.dll을 입력해주시면 해결이 됩니다.  나머지 설치를 진행해주시고 설치가 완료된 후에 로그인을 하면 ...
자세한 내용 보기