Skillware: AI 에이전트를 위한 모듈형 스킬 관리 프레임워크

섹션별 상세

Skillware는 에이전트의 지능과 구체적인 수행 능력을 분리하여 기능을 설치 가능한 콘텐츠로 취급한다. 이는 지능을 담당하는 LLM과 실제 작업을 수행하는 도구 간의 결합도를 낮추어 유연한 시스템 설계를 가능하게 한다.

하나의 스킬은 Python 코드로 작성된 Logic, 시스템 지침을 포함하는 Cognition, 안전 경계를 정의하는 Governance, 도구 호출 스키마인 Interface로 구성된다. 이러한 4가지 요소의 결합을 통해 에이전트가 특정 도메인을 마스터하는 데 필요한 모든 요소를 패키지화한다.

프레임워크 아키텍처는 핵심 로직인 core, 도메인별 스킬 저장소인 registry, 템플릿 및 예시 코드로 체계화되어 있다. 특히 SkillLoader는 manifest.yaml 파일을 읽어 의존성을 자동으로 검증하고 모델별 어댑터를 통해 스킬을 로드한다.

모델 어댑터 시스템은 Gemini, Claude, OpenAI 등 서로 다른 SDK 환경에서도 동일한 스킬 번들을 사용할 수 있도록 지원한다. 개발자는 SkillLoader.to_gemini_tool()과 같은 메서드를 호출하여 로드된 스킬을 각 모델의 도구 형식으로 즉시 변환한다.

python

import google.generativeai as genai
from skillware.core.loader import SkillLoader
from skillware.core.env import load_env_file

load_env_file()
skill_bundle = SkillLoader.load_skill("category/skill_name")

model = genai.GenerativeModel(
    'gemini-2.5-flash',
    tools=[SkillLoader.to_gemini_tool(skill_bundle)],
    system_instruction=skill_bundle['instructions']
)
chat = model.start_chat(enable_automatic_function_calling=True)
response = chat.send_message("Screen wallet 0xd8dA... for risks.")
print(response.text)

로드된 스킬을 Gemini 모델의 도구로 변환하여 에이전트를 실행하는 예시 코드

기존 MCP와 달리 Skillware는 특정 모델에 종속되지 않는 코드 중심의 런타임 환경을 지향한다. 단순한 서버 명세 정의를 넘어 실제 실행 가능한 Python 패키지로서의 스킬 관리에 초점을 맞춘다.

용어 해설

도구 호출(Tool Calling): — LLM이 텍스트 생성 중 외부 함수나 API를 실행하기 위해 필요한 인자를 구조화된 데이터 형식으로 생성하고 그 결과를 다시 입력으로 받아 처리하는 메커니즘이다. 모델이 단순 답변을 넘어 실제 동작을 수행하게 만드는 핵심 기술로, 에이전트의 실행 능력을 결정짓는 중요한 요소이다.
모델 컨텍스트 프로토콜(Model Context Protocol): — Anthropic이 제안한 모델 컨텍스트 프로토콜로, 다양한 데이터 소스와 도구를 AI 모델에 연결하기 위한 개방형 표준 인터페이스이다. 모델과 외부 환경 간의 통신 방식을 규격화하여 상호운용성을 높이지만, Skillware는 이보다 더 실행 코드 중심적인 접근을 취한다.
시스템 프롬프트(System Prompt): — LLM에게 부여되는 초기 지침으로, 모델의 역할, 페르소나, 대화 규칙, 제약 사항 등을 설정하여 전체 응답의 맥락과 톤을 제어한다. 에이전트의 인지적 경계를 설정하고 특정 작업에 최적화된 행동을 유도하는 데 필수적인 구성 요소이다.

코드 예제

bash

pip install skillware

Skillware 프레임워크를 PyPI를 통해 설치하는 명령어

기술

Python
Gemini API
Claude API
Skillware

활용 사례

멀티 모델 에이전트 구축
표준화된 도구 라이브러리 관리
에이전트 기능의 동적 로딩

언급된 리소스

GitHubSkillware GitHub Repository