zjunlp/SkillNet

SkillNet – 재사용 가능한 AI 에이전트 스킬 인프라

그것이 무엇인가 – SkillNet은 스킬(AI 에이전트가 특정 기능을 수행하기 위해 호출할 수 있는 자체 포함 코드(일반적으로 SKILL.md 설명이 포함된 폴더))을 발견, 설치, 생성, 평가, 분석 및 라우팅할 수 있는 오픈소스 플랫폼입니다(예: "PDF에서 테이블 추출", "CSV 품질 확인", "scRNA-seq 분석 실행").

왜 중요한가 – 최신 LLM 기반 에이전트는 프롬프트 내에서 모든 것을 시도하는 대신 전문 도구를 플러그인할 수 있을 때 더 유용합니다. SkillNet은 이러한 도구를 위한 통합 수명 주기, GitHub에서 호스팅되는 50만 개 이상의 스킬이 있는 공개 카탈로그, 에이전트가 자동으로 가져와 구성하는 데 사용할 수 있는 Python SDK/CLI를 제공합니다.

핵심 구성 요소

구성 요소	기능
웹 카탈로그	`skillnet.openkg.cn`에서 공개 스킬 라이브러리 탐색 및 검색(키워드 또는 벡터 검색). 설명, 안전성/유지보수성 등급, 별점, 다운로드 링크를 표시합니다.
Python SDK (`skillnet‑ai`)	6가지 작업(`search`, `download`, `create`, `evaluate`, `analyze`, `route`)을 노출하는 프로그래밍 방식 클라이언트(`SkillNetClient`).
로컬 UI	Node.js 없이 자체 스킬 폴더, 분석 그래프 및 관계 증거를 시각화하는 경량 브라우저(`skillnet ui`).
SkillNet‑Gym	스킬 구축, 검색 및 구성을 위한 벤치마크 스위트(논문에서 언급).
SkillNet‑Fabric	주어진 작업에 대한 스킬 지식 그래프를 구축하는 Wiki 스타일 라우팅 시스템.
MCP 서버	SkillNet 모델 컨텍스트 프로토콜을 따르는 에이전트를 위해 CLI를 도구 서비스로 노출하는 래퍼.

빠른 시작(설치 및 기본 사용)

# 핵심 SDK 설치(Python 3.10+ 필요)
pip install "skillnet-ai[ui]"   # UI는 선택 사항이며 로컬 브라우저를 추가합니다

# 클라이언트 초기화(API 키에 대한 환경 변수 읽기)
python - <<'PY'
from skillnet_ai import SkillNetClient
client = SkillNetClient()

# 1️⃣ 공개 카탈로그 검색(벡터 모드, 높은 유사도)
results = client.search(q="extract tables from pdf", mode="vector", threshold=0.85, limit=5)
for s in results:
    print(s.skill_name, s.stars, s.skill_url)

# 2️⃣ 작업 공간에 스킬 다운로드
path = client.download(url="https://github.com/anthropics/skills/tree/main/skills/pdf", target_dir="./my_skills")
print("downloaded to", path)

# 3️⃣ 다운로드한 스킬 평가(안전성, 완전성 등)
report = client.evaluate(path)
print(report)

# 4️⃣ 여러 스킬이 포함된 폴더 분석 – 시나리오 그래프와 인덱스 구축
analysis = client.analyze("./my_skills", output_dir="./skillnet_index")
print("graph stored in", analysis.index_dir)

# 5️⃣ 사용자 요청을 가장 적합한 스킬로 라우팅
route = client.route(
    "Extract tables from my PDF report and validate the CSV for missing values",
    index_dir="./skillnet_index",
    k=3,
)
for sel in route.skills:
    print(sel.skill_id, sel.name, sel.reason)
PY

주요 기능(전문 용어 없이)

통합 수명 주기 – 발견부터 실행 라우팅까지 전체 프로세스를 다루는 하나의 도구.
의미론적 검색 – 고전적인 BM25 키워드 검색과 임베딩 기반 벡터 검색을 모두 지원.
자동 스킬 생성 – create는 자연어 프롬프트, 저장소, 문서 또는 실행 추적에서 새 스킬을 합성할 수 있습니다.
안전성 및 품질 평가 – 5가지 차원(안전성, 완전성, 실행 가능성, 유지보수성, 비용)이 자동으로 점수화됩니다.
그래프 기반 분석 – compose_with(한 스킬의 출력이 다른 스킬에 입력됨) 및 similar_to 관계를 추출하고 재사용 가능한 인덱스로 저장합니다.
하이브리드 라우팅 – 벡터 유사성, 그래프 확장 및 작업별 Wiki를 읽고 가장 적절한 스킬을 선택하는 LLM(Claude 또는 Codex)을 결합하여 각 선택에 대해 사람이 읽을 수 있는 이유를 제공합니다.
로컬 UI – 간단한 웹 페이지(http://127.0.0.1:8765)를 통해 스킬 폴더 탐색, 분석 그래프 보기, 소스 줄까지 증거 추적.
에이전트 통합 – 기성 "SkillNet" 스킬을 OpenClaw, JiuwenClaw 또는 MCP 호환 시스템에 추가할 수 있습니다.

구성 기본 사항

변수	용도
`API_KEY`	OpenAI 호환 채팅 엔드포인트 키(`create`, `evaluate`, `analyze`에서 사용).
`BASE_URL`	채팅 완성 엔드포인트(기본값 `https://api.openai.com/v1`).
`SKILLNET_MODEL`	생성/평가용 모델(기본값 `gpt-4o`).
`GITHUB_TOKEN`	비공개 저장소 또는 더 높은 속도 제한을 위한 선택적 토큰.
`EMBEDDING_*`	임베딩용 엔드포인트 및 모델(`analyze` 및 `route`에 필요).
`SKILLNET_EXPLORER_BACKEND`	라우터가 사용하는 LLM(Claude 또는 Codex).
`SKILLNET_API_URL`	공개 검색 서비스(기본값 `http://api-skillnet.openkg.cn`).

SDK/CLI를 호출하기 전에 셸 또는 .env 파일에서 설정하세요.

생태계 및 커뮤니티

웹 카탈로그 – skillnet.openkg.cn(검색, 큐레이션된 컬렉션, SkillNet‑Gym/Fabric 데모).
MCP 서버 – skillnet-mcp 저장소(SkillNet 모델 컨텍스트 프로토콜을 사용하는 에이전트를 위해 CLI를 래핑).
통합 – OpenClaw, JiuwenClaw 및 기타 에이전트 프레임워크는 내장 SkillNet 스킬을 로드할 수 있습니다.
벤치마크 – ALFWorld, WebShop, ScienceWorld용 재현 스크립트가 experiments/ 아래에 제공됩니다.
논문 및 인용 – arXiv:2603.04448 (2026)에서 방법론을 설명합니다. 인용이 제공됩니다.

도움 받기

CLI 도움말 – skillnet <command> --help(또는 python -m skillnet_ai).
닥터 명령 – skillnet doctor --json은 환경과 필요한 키를 확인합니다.
대화형 구성 – skillnet configure --interactive는 로컬 구성 파일을 작성합니다.
GitHub 이슈 – 버그 또는 기능 요청은 저장소의 이슈 트래커를 사용하세요.

라이선스

핵심 코드는 MIT 라이선스입니다. 개별 스킬은 원래 라이선스를 유지합니다.

요약: SkillNet은 재사용 가능한 AI 에이전트 스킬 라이브러리를 구축하고, 품질을 평가하며, 사용자 요청에 적합한 스킬을 자동으로 라우팅하기 위한 풀스택 오픈소스 솔루션입니다. 공개 웹 카탈로그, Python SDK/CLI 및 선택적 UI를 통해 작동하므로 모든 LLM 기반 에이전트 시스템에 쉽게 연결할 수 있습니다.