ONEDEV

skilldock.io

AI Agent FrameworksskillPython

★ 86조회 2

무엇인가

SkillDock 레지스트리에 등록된 재사용 가능한 AI 스킬을 검색·조회·설치·배포하는 작업을 하나의 절차로 규율한다. 스킬을 버전이 붙은 아티팩트로 취급하고 네임스페이스·슬러그·버전 세 축으로 식별하며, 설치 시 의존성을 재귀적으로 해석해 로컬 디렉터리에 배치하는 흐름을 정의한다.

어떻게 동작하나

동작은 OpenAPI 스펙 로딩에서 시작한다. 클라이언트는 런타임에 스펙을 읽어 모든 operationId를 Python 메서드와 CLI 하위 명령으로 노출하고, `skilldock ops`가 그 목록을 python_name과 함께 출력한다. 인증은 브라우저 로그인 후 폴링으로 access_token을 받아 저장하는 경로와, CI용 장기 personal API token을 발급해 저장하는 경로 두 가지를 둔다. 배포는 대상 폴더를 zip으로 묶어 multipart `file` 필드로 업로드하며, 태그는 업로드 인자가 아니라 zip 내부 SKILL.md frontmatter에서 백엔드가 읽는다.

무엇과 다른가

프롬프트를 매번 직접 쓰거나 저장소에 정적 규칙 파일을 복사해 두는 방식과 달리, 스킬을 레지스트리에서 버전 단위로 가져오고 릴리스 이력·의존성·접근 권한을 서버가 관리한다. 클라이언트가 스펙 기반이므로 API에 엔드포인트가 추가되어도 호출 코드를 새로 작성하지 않고 operationId로 접근한다. 릴리스 버전이 불변이어서 같은 버전을 덮어쓰는 대신 새 버전을 발행하는 규율이 강제된다.

어떻게 쓰나

설치는 `pip install skilldock` 한 줄로 끝나고, 이후 `skilldock ops`로 사용 가능한 작업을 확인한다. 인증이 필요하면 `skilldock auth login`을 실행하고, 스킬은 `skilldock install <namespace>/<slug>`로 기본 `./skills` 디렉터리에 받는다. `--version`으로 정확한 릴리스, `--skills-dir`로 대상 경로를 지정한다. 배포는 `skilldock skill upload --namespace ... --slug ... --version ... --path .` 형태로 폴더를 그대로 올린다.

전제와 한계

Skills 호환 에이전트가 쓰는 스킬을 다루는 도구이며, 실행 자체는 Python과 pip 설치를 전제한다. 공개 스킬 설치는 인증 없이 가능하지만 비공개 스킬 해석과 배포에는 토큰이 필요하다. 결제는 현재 TON 레일만 동작하고 Stripe는 일시적으로 사용할 수 없다. 릴리스 버전이 불변이어서 SKILL.md를 고치면 같은 버전 재배포가 충돌로 거부되고, 태그는 별도 업로드 필드가 없어 frontmatter에만 의존한다.

관련 논문 2

유사 도구