SKILL.md를 API로 변환하는 런타임, Skrun으로 구현한 AI 에이전트 자동화

Context

SKILL.md 파일 기반의 AI 에이전트 기술이 특정 툴 내부에 고립된 구조. 외부 서비스의 Webhook이나 POST 요청으로 호출할 방법이 부재한 한계. 도구 간 종속성 없이 에이전트 기술을 API 형태로 배포할 필요성 증대.

Technical Solution

• SKILL.md 파일을 읽어 agent.yaml 설정 파일로 자동 변환하는 초기화 프로세스 설계
• 특정 모델에 종속되지 않도록 Anthropic, OpenAI, Google 등 멀티 모델 제공자를 지원하는 추상화 레이어 구현
• 모델 장애 발생 시 다음 우선순위 모델로 자동 전환하는 Fallback 메커니즘 적용
• 쉘, Node, Python 등 외부 스크립트를 agent.yaml에 등록하여 LLM이 필요 시 호출하는 Tool calling 구조 채택
• MCP(Model Context Protocol) 서버 연동을 통해 npm 생태계의 외부 도구를 npx로 즉시 실행하는 확장 방식 도입
• 에이전트 실행 간 핵심 데이터를 유지하여 연속성을 제공하는 Key-Value 기반의 상태 저장 설계

Impact

• 4개의 패키지 구성
• 10개의 CLI 명령어 제공
• 154개의 테스트 케이스 확보
• 6개의 데모 에이전트 구현

Key Takeaway

프롬프트 기반의 정적인 기술 명세(Skill)를 실행 가능한 API 런타임으로 추상화하여 AI 에이전트의 배포 및 통합 비용을 최소화함.