Skillry MCP 도구 참조

연결된 MCP 클라이언트에서 호출합니다. 보통 Agent가 인수를 입력하며, 이 문서는 호출 확인과 통합 개발을 위한 자료입니다.

skillry-cli@lateststdioskills:read

확인일: 2026년 10월 26일

도구를 호출하기 전에

클라이언트에 추가

Skillry는 Node.js 22+가 있는 macOS 또는 Windows에서 로컬 stdio 서버를 사용합니다. 자격 증명은 OS 자격 증명 저장소에 보관합니다. /mcp는 설정 페이지이며 원격 MCP 엔드포인트가 아닙니다.

계정과 승인

계정 호출은 skills:read 범위의 브라우저 승인을 사용합니다. 현재 자격 증명은 7일 후 만료되며 자동 갱신은 없습니다. 같은 컴퓨터의 CLI와 MCP는 같은 서비스 URL의 자격 증명을 공유하므로 연결 해제 시 함께 취소됩니다.

설치 전 요구 사항과 접근 권한을 확인하고 사용자가 선택한 Skill과 버전을 유지하세요. 설치는 Skill 실행, 접근 권한 구매, 외부 서비스 결제를 수행하지 않습니다.

<skill-slug>는 search_skills 결과의 slug로, <published-version>은 선택한 공개 버전으로 바꾸세요. 경로는 본인 컴퓨터의 절대 경로를 사용하세요.

검색과 탐색

search_skills

공개

원하는 결과물과 명시한 요구 사항으로 공개 Skill을 검색합니다. 기본값은 키워드 검색이며 검색 일치가 현재 환경에서의 실행을 보장하지는 않습니다.

매개변수9

querystring선택

원하는 결과물 또는 정확한 이름/slug입니다. 입력 PDF나 URL 대신 원하는 출력 내용을 설명하세요.

maxLength: 200 · 기본값 ""

outputTypestring선택

원하는 출력 유형으로 필터링합니다. 프레젠테이션의 API 값은 presentation입니다.

deliveryScopestring선택

완성된 결과물 또는 구성 요소를 선택합니다. 제공 범위 정보가 없으면 검토가 필요합니다.

complete | component

avoidVoiceoverboolean선택

true로 설정하면 핵심 흐름에 음성 해설이 필요하다고 명시한 후보를 제외합니다.

allowApiKeysboolean선택

false로 설정하면 제공업체 Key가 필수라고 명시한 후보를 제외합니다. 명시되지 않은 항목은 알 수 없음으로 남습니다.

allowExternalCostsboolean선택

false로 설정하면 외부 비용이 명시된 후보를 제외합니다. 알 수 없는 비용은 검토해야 합니다.

limitinteger선택

호출당 최대 결과 수입니다. 해당 도구에 표시된 범위와 기본값을 따르세요.

≥ 1 · ≤ 20 · 기본값 5

offsetinteger선택

페이지 시작 위치입니다. 다음 호출에는 반환된 nextOffset를 사용하세요.

≥ 0 · ≤ 10000 · 기본값 0

localestring선택

콘텐츠 언어입니다. zh-CN, zh-TW, pt-BR 등 정확한 API 값을 사용하세요.

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · 기본값 "en"

인수 예제 · JSON

{
  "query": "product presentation",
  "outputType": "presentation",
  "avoidVoiceover": true,
  "allowApiKeys": false,
  "allowExternalCosts": false,
  "limit": 3
}

결과와 동작

skills, nextOffset, 검색·검토 상태를 반환합니다. appliedRequirements, requirementReview, costNotice, clarificationQuestion을 확인하세요. 알 수 없는 요구 사항은 검토해야 합니다. constraintsStatus: unconfirmed는 서버가 조건 적용을 확인하지 않았다는 뜻입니다. 점수는 확률이 아닙니다.

get_skill

공개

선택 전에 공개 Skill 하나의 버전, 미리보기 링크, 입력, 의존성 및 외부 비용을 확인합니다.

매개변수1

slugstring필수

사용자가 선택한 공개 Skill의 정확한 slug입니다. 소문자 kebab-case이며 최대 64자입니다.

minLength: 1 · maxLength: 64

인수 예제 · JSON

{
  "slug": "<skill-slug>"
}

결과와 동작

공개 버전 메타데이터를 반환합니다. 접근 권한을 부여하거나 비공개 패키지 내용을 제공하지 않습니다.

계정과 승인

connect_account

브라우저 승인 흐름

사용자가 연결을 요청하면 브라우저 계정 승인을 시작합니다. 진행 중인 흐름이 있으면 재사용합니다.

매개변수인수가 없습니다. 빈 객체를 전달하세요.

결과와 동작

verificationUrl, userCode, expiresAt, browserOpened, pollAfterSeconds를 반환합니다. 사용자에게 URL과 일치 코드를 보여 주세요. 자격 증명은 반환하지 않습니다.

connection_status

브라우저 승인 흐름

진행 중인 승인을 이어갑니다. 반환된 pollAfterSeconds 간격을 지켜 다시 호출하세요.

매개변수인수가 없습니다. 빈 객체를 전달하세요.

결과와 동작

not_started, pending, denied, expired, connected 상태를 보고합니다. 승인 후 토큰을 OS 저장소에 저장합니다. 폴링 간격을 지키세요.

account_status

계정 필요

현재 멤버십, 승인 만료 시각, 권한 범위와 일일 다운로드 한도를 확인합니다.

매개변수인수가 없습니다. 빈 객체를 전달하세요.

결과와 동작

connected, entitlement, scope, sessionExpiresAt, quota, pricingUrl을 반환합니다. 개인 식별 정보와 자격 증명은 포함하지 않습니다.

disconnect_account

계정 필요

대기 중인 승인을 취소하고 공유 CLI/MCP 자격 증명을 폐기한 뒤 OS 저장소에서 삭제합니다.

매개변수인수가 없습니다. 빈 객체를 전달하세요.

결과와 동작

serverRevoked를 확인하세요. 원격 취소가 실패해도 로컬 자격 증명은 삭제되지만 서버 토큰은 만료 전까지 유효할 수 있습니다.

get_skill_access

계정 필요

다운로드 전에 공개 Skill의 접근 권한을 확인합니다. 한도를 예약하거나 소모하지 않습니다.

매개변수1

slugstring필수

사용자가 선택한 공개 Skill의 정확한 slug입니다. 소문자 kebab-case이며 최대 64자입니다.

minLength: 1 · maxLength: 64

인수 예제 · JSON

{
  "slug": "<skill-slug>"
}

결과와 동작

access(free, purchased, member, purchase_required), canDownload, reason, purchaseUrl, version, quota를 반환합니다. 다운로드 시 권한을 다시 확인합니다.

다운로드, 설치 및 업데이트

download_skill

계정 필요로컬 파일 변경

검증된 Skill ZIP을 지정한 절대 경로 디렉터리에 저장합니다. 기존 파일을 덮어쓰지 않습니다.

매개변수3

slugstring필수

사용자가 선택한 공개 Skill의 정확한 slug입니다. 소문자 kebab-case이며 최대 64자입니다.

minLength: 1 · maxLength: 64

downloadDirectorystring필수

ZIP을 저장할 명시적 절대 디렉터리입니다. Agent나 설치 범위는 사용하지 않습니다.

maxLength: 4096

expectedVersionstring선택

선택한 공개 버전입니다. 업데이트에는 필수이고 설치/다운로드에는 선택입니다. 공개 버전이 바뀌면 다시 검토하세요.

minLength: 1 · maxLength: 64

인수 예제 · JSON

{
  "slug": "<skill-slug>",
  "downloadDirectory": "/absolute/path/downloads",
  "expectedVersion": "<published-version>"
}

결과와 동작

ZIP 무결성과 버전을 확인한 뒤 archivePath, slug, version, sha256을 반환합니다. 설치하거나 설치 완료를 보고하지 않습니다.

install_skill

계정 필요로컬 파일 변경

선택한 버전을 명시한 Agent와 범위에 설치합니다. 기존 Skill 디렉터리를 덮어쓰지 않습니다.

매개변수5

slugstring필수

사용자가 선택한 공개 Skill의 정확한 slug입니다. 소문자 kebab-case이며 최대 64자입니다.

minLength: 1 · maxLength: 64

agentstring필수

설치 대상이며 MCP 호스트 이름과 구분됩니다. global은 대상의 Skills 디렉터리를 사용하고 project는 shared 또는 claude-code만 허용합니다.

scopestring선택

global은 현재 OS 사용자용 설치이고 project는 명시한 projectDirectory 아래에 설치합니다.

global | project · 기본값 "global"

projectDirectorystring선택

프로젝트 절대 경로입니다. scope: project에서 필수이며 scope: global에서는 허용하지 않습니다. shared는 .agents/skills, claude-code는 .claude/skills를 사용합니다.

maxLength: 4096

expectedVersionstring선택

선택한 공개 버전입니다. 업데이트에는 필수이고 설치/다운로드에는 선택입니다. 공개 버전이 바뀌면 다시 검토하세요.

minLength: 1 · maxLength: 64

인수 예제 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

결과와 동작

targetPath, skillFile, version, completionReported, inventoryRecorded를 반환합니다. 실행 전 SKILL.md와 비용을 확인하세요.

list_installed_skills

로컬 파일

선택한 로컬 디렉터리의 Skill을 읽습니다. Skillry가 관리하는 설치에만 공개 버전이 기록됩니다.

매개변수3

agentstring필수

설치 대상이며 MCP 호스트 이름과 구분됩니다. global은 대상의 Skills 디렉터리를 사용하고 project는 shared 또는 claude-code만 허용합니다.

scopestring선택

global은 현재 OS 사용자용 설치이고 project는 명시한 projectDirectory 아래에 설치합니다.

global | project · 기본값 "global"

projectDirectorystring선택

프로젝트 절대 경로입니다. scope: project에서 필수이며 scope: global에서는 허용하지 않습니다. shared는 .agents/skills, claude-code는 .claude/skills를 사용합니다.

maxLength: 4096

인수 예제 · JSON

{
  "agent": "shared",
  "scope": "global"
}

결과와 동작

로컬 항목과 managed/version 상태를 반환합니다. 비관리 Skill의 버전은 알 수 없으며 자동으로 업그레이드할 수 없습니다.

check_updates

로컬 파일

관리 중인 설치를 공개 버전과 비교합니다. 확인만으로 다운로드나 업데이트를 수행하지 않습니다.

매개변수5

agentstring필수

설치 대상이며 MCP 호스트 이름과 구분됩니다. global은 대상의 Skills 디렉터리를 사용하고 project는 shared 또는 claude-code만 허용합니다.

scopestring선택

global은 현재 OS 사용자용 설치이고 project는 명시한 projectDirectory 아래에 설치합니다.

global | project · 기본값 "global"

projectDirectorystring선택

프로젝트 절대 경로입니다. scope: project에서 필수이며 scope: global에서는 허용하지 않습니다. shared는 .agents/skills, claude-code는 .claude/skills를 사용합니다.

maxLength: 4096

offsetinteger선택

페이지 시작 위치입니다. 다음 호출에는 반환된 nextOffset를 사용하세요.

≥ 0 · ≤ 9007199254740991 · 기본값 0

limitinteger선택

호출당 최대 결과 수입니다. 해당 도구에 표시된 범위와 기본값을 따르세요.

≥ 1 · ≤ 5 · 기본값 5

인수 예제 · JSON

{
  "agent": "shared",
  "scope": "global",
  "offset": 0,
  "limit": 5
}

결과와 동작

각 항목의 current, update_available, unavailable, unmanaged 및 nextOffset를 반환합니다. 다음 조회도 같은 Agent와 범위를 사용하세요.

update_skill

계정 필요로컬 파일 변경

컴퓨터에 설치된 Skillry 관리 Skill을 사용자가 명시적으로 승인한 버전으로 업데이트합니다. 로컬 수정 사항을 포함한 이전 디렉터리 전체를 백업합니다.

매개변수5

agentstring필수

설치 대상이며 MCP 호스트 이름과 구분됩니다. global은 대상의 Skills 디렉터리를 사용하고 project는 shared 또는 claude-code만 허용합니다.

scopestring선택

global은 현재 OS 사용자용 설치이고 project는 명시한 projectDirectory 아래에 설치합니다.

global | project · 기본값 "global"

projectDirectorystring선택

프로젝트 절대 경로입니다. scope: project에서 필수이며 scope: global에서는 허용하지 않습니다. shared는 .agents/skills, claude-code는 .claude/skills를 사용합니다.

maxLength: 4096

slugstring필수

사용자가 선택한 공개 Skill의 정확한 slug입니다. 소문자 kebab-case이며 최대 64자입니다.

minLength: 1 · maxLength: 64

expectedVersionstring필수

선택한 공개 버전입니다. 업데이트에는 필수이고 설치/다운로드에는 선택입니다. 공개 버전이 바뀌면 다시 검토하세요.

minLength: 1 · maxLength: 64

인수 예제 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

결과와 동작

교체 시 설치 버전과 backupPath를 반환합니다. 이미 지정한 버전이면 교체하지 않습니다.

설치 디렉터리

global에서 shared, codex, cursor, gemini-cli, opencode, kimi-code는 ~/.agents/skills, claude-code는 ~/.claude/skills, antigravity는 ~/.gemini/config/skills를 사용합니다. project는 <projectDirectory>/.agents/skills 또는 <projectDirectory>/.claude/skills를 사용합니다. MCP 프로세스 작업 디렉터리로 프로젝트를 추측하지 마세요.

인수 예제 · install_skill

{
  "slug": "<skill-slug>",
  "agent": "claude-code",
  "scope": "project",
  "projectDirectory": "/absolute/path/project",
  "expectedVersion": "<published-version>"
}

상태와 문제 해결

계정 미승인 또는 승인 만료: authentication_required 또는 session_expired이면 사용자에게 연결 의사를 확인하고 connect_account를 호출하세요. URL/코드를 보여 주고 지정 간격으로 connection_status를 확인한 뒤 승인되면 원래 작업을 다시 시도하세요.
Skill 디렉터리가 이미 존재함: skill_already_installed이면 같은 대상을 list_installed_skills와 check_updates로 확인하세요. 관리 중인 설치를 선택한 새 버전으로 업데이트하기 전에 승인을 요청하세요. MCP에는 force 인수가 없습니다.
구매 필요 또는 일일 한도 도달: purchase_required 또는 premium_required이면 purchaseUrl/actionUrl을 안내하고 daily_download_limit이면 resetsAt를 표시하세요. 같은 날 같은 Skill을 반복 다운로드하면 별도 Skill 한도를 더 쓰지 않습니다. UTC 00:00에 초기화됩니다.
Skillry 도구가 표시되지 않음: Node.js 22+, 선택한 OS 설정과 클라이언트 로그를 확인하세요. 서버 추가 후 클라이언트를 다시 시작하거나 새로 고치세요. 현재 설정은 브라우저 전용 환경과 Linux를 지원하지 않습니다.

더 읽어보기

클라이언트 연결 Skillry MCP 연결 Model Context Protocol