AI-Assisted Engineering Talk #13/27
에이전트를 만들지 말고, 스킬을 만들어라 — 전문성을 패키징하는 새로운 방법
핵심 주장
범용 에이전트는 똑똑하지만 매번 처음부터 원리를 파악하려 합니다. 코드는 디지털 세계의 범용 인터페이스이기에 에이전트의 스캐폴딩이 bash와 파일 시스템만으로도 얇아질 수 있습니다. 하지만 그 얇은 스캐폴딩 위에 전문성이 없으면, 같은 실수를 반복하는 것이지요.
Anthropic의 해법은 스킬(Skill)이라는 개념입니다. 스킬은 “조합 가능한 절차적 지식을 패키징한 파일 모음"으로, 의도적으로 단순하게 설계되었습니다. 폴더 하나, 마크다운 몇 장, 스크립트 몇 개. Git으로 버전 관리하고, 구글 드라이브에 넣고, zip으로 공유할 수 있을 만큼 평범합니다.
스킬 안의 스크립트는 자기문서화된 도구로 기능합니다. 전통적 도구의 문제 — 모호한 지시, 수정 불가, 상시 컨텍스트 상주 — 를 해결합니다. Claude가 반복 작성하던 코드를 스킬에 저장하면, 미래의 자신을 위한 도구가 됩니다.
수백 개의 스킬을 동시에 장착하면서도 컨텍스트 윈도우를 보호하는 핵심은 점진적 공개(progressive disclosure)입니다. 런타임에는 메타데이터만 노출하고, 특정 작업에 필요하다고 판단될 때만 skill.md의 핵심 지시와 폴더 구조를 읽어들입니다.
MCP와 스킬은 대체재가 아니라 보완재입니다. MCP 서버가 외부 데이터와 도구에 대한 연결(connectivity)을 제공한다면, 스킬은 그 도구들을 활용하는 전문성(expertise)을 제공합니다. 여러 MCP 도구를 엮어 복잡한 워크플로우를 오케스트레이션하는 것이 스킬의 역할입니다.
스킬의 핵심 개념
절차적 지식의 패키지
스킬은 폴더다. 마크다운으로 지시를 쓰고, 스크립트로 도구를 만들고, Git으로 관리한다. 의도적으로 단순해야 누구나 만들 수 있다.
자기문서화 스크립트
코드 자체가 문서이자 도구다. 전통적 도구와 달리 모델이 직접 읽고, 수정하고, 필요할 때만 파일 시스템에서 꺼내 쓴다.
점진적 공개
런타임에는 스킬의 메타데이터만 노출한다. 에이전트가 특정 작업에 필요하다고 판단할 때 비로소 전체 지시를 읽어들인다. 수백 개 스킬과 유한한 컨텍스트의 양립.
MCP와의 분업
MCP는 연결, 스킬은 전문성. MCP가 외부 도구에 대한 접근을 열어주면, 스킬이 그 도구들을 엮어 복잡한 워크플로우를 조율한다.
3계층 생태계
기반 스킬(범용 능력), 서드파티 스킬(파트너 소프트웨어 전문성), 엔터프라이즈 스킬(조직 고유 베스트 프랙티스). Fortune 100 기업이 수천 명을 위한 스킬 배포에 사용 중.
비기술자의 접근성
재무, 채용, 회계, 법무 등 비기술 직군이 자신의 업무를 위한 스킬을 만들고 있다. 코딩 에이전트를 넘어 범용 에이전트로 확장될 수 있다는 초기 검증.
지속 학습과 지식 복리
스킬에 축적된 피드백과 제도적 지식은 팀 전체 에이전트를 동시에 강화한다. Day 30의 Claude는 Day 1보다 훨씬 낫다. 새 팀원이 합류해도 Claude는 이미 그 팀의 일하는 방식을 안다.
미래 과제: 테스트, 버저닝, 의존성
스킬이 복잡해지면서 소프트웨어와 동일한 엔지니어링이 필요해진다. 스킬 로딩의 정확성 테스트, 버전별 행동 계보 추적, 명시적 의존성 선언이 향후 과제.
검증된 인사이트
💡 [Insight] 스킬은 에이전트의 앱 스토어다
모델은 프로세서(거대한 투자, 엄청난 잠재력, 단독으로는 제한적), 에이전트 런타임은 OS(프로세스와 자원 오케스트레이션), 스킬은 앱(도메인 전문성과 고유 관점 인코딩). 소수만 프로세서와 OS를 만들지만, 수백만이 앱을 만듭니다. 스킬은 이 application 레이어를 여는 것이며, 5주 만에 수천 개 스킬 생태계가 형성된 것이 이 유비의 현실성을 증명합니다.
💡 [Insight] 절차적 지식만 포착하기에 즉시 활용 가능
스킬이 포착하는 것은 모든 정보가 아니라 절차적 지식입니다. 바로 그래서 특정 작업에 즉시 활용할 수 있고, 전이가 가능합니다. 스킬의 표준 포맷은 Claude가 기록한 것을 미래의 자신이 효율적으로 재사용할 수 있다는 보장을 제공합니다. 이것은 단순한 메모리가 아니라, 구조화된 학습의 전이입니다.
💡 [Insight] 조직 지식의 복리 효과
개인의 피드백이 스킬에 축적되면 팀 전체 에이전트가 동시에 강화됩니다. 커뮤니티 수준으로 확장되면 다른 사람이 만든 스킬이 내 에이전트를 강화합니다. MCP가 도구의 네트워크 효과를 만들었다면, 스킬은 전문성의 네트워크 효과를 만들 수 있는 구조입니다. 진화하는 집단 지식 베이스라는 비전은, 이미 Fortune 100 기업에서 실현되고 있습니다. ## 다른 영상과의 교차점
- 12-Factor Agents (Dex Horthy) — Factor 2(프롬프트를 직접 소유하라)와 스킬의 skill.md는 같은 맥락입니다. 프레임워크에 프롬프트를 맡기지 않듯, 에이전트의 전문성도 모델 내부에 맡기지 않고 파일 시스템에 명시적으로 소유합니다. Factor 10(작고 집중된 에이전트)은 스킬의 조합성과 정확히 대응합니다.
- Making Codebases Agent Ready (Eno Reyes, Factory) — “에이전트는 컨텍스트에 매우 반응적이다"라는 Factory의 명제와 점진적 공개(progressive disclosure)는 같은 문제의 양면입니다. Factory가 코드베이스의 컨텍스트를 정비하라고 했다면, Anthropic은 스킬의 메타데이터로 컨텍스트 밀도를 관리하라고 합니다.
- Vibes won’t cut it (Chris Kelly, Augment) — “컨텍스트가 AI 코드 생성의 1순위"라는 Chris의 선언은 스킬이 해결하려는 바로 그 문제입니다. rules 파일과 plan markdown의 Create-Refine 루프는 사실상 스킬의 수동 버전이었으며, Anthropic은 이를 구조화된 포맷으로 끌어올렸습니다.
- Collaborating with Agents (Microsoft Copilot) — copilot-instructions.md, .github/instructions 파일 체계는 스킬의 skill.md + 스크립트 구조와 놀랍도록 유사합니다. 차이점은 Anthropic이 점진적 공개라는 런타임 최적화를 추가하여 수백 개 규모의 조합성을 확보했다는 점입니다.
- How Coding Agents change SDE Forever — “워크플로우에 사는 작은 에이전트들” 비전의 실현 형태가 바로 스킬입니다. 하나의 거대 에이전트 대신, 각 워크플로우에 특화된 스킬을 조합하여 전문성을 갖춘 에이전트를 만드는 것이지요.
이 발표를 보며 가장 인상 깊었던 것은, Anthropic이 스킬을 의도적으로 단순하게 설계했다는 점이옵니다. 폴더 하나, 마크다운 몇 장. 재무 담당자도 만들 수 있을 만큼 평범한 구조 위에, 점진적 공개라는 정교한 런타임 최적화를 얹었습니다. 단순한 것이 강력한 것이라는 진리가 다시 한번 증명된 셈이지요. 고향에서는 이런 것을 두고 “큰 그릇일수록 담김새가 소박하다"고 하였습니다.