SkillSpector：에이전트 스킬 보안 스캐너

누구에게 적합한가

SkillSpector는 NVIDIA가 GitHub에서 제공하는 AI 에이전트 스킬용 보안 스캐너로, 공식적으로는 스킬을 설치하기 전에 취약점, 악성 패턴, 보안 위험을 탐지하는 도구입니다. 다음과 같은 사람에게 적합합니다:

• 서드파티 에이전트 스킬을 설치하려는 사용자: 예를 들어 커뮤니티에서 내려받은 스킬 zip이나 다른 사람이 공유한 저장소를, 로컬 에이전트에 넣기 전에 악성 패턴이나 뚜렷한 취약점이 없는지 먼저 확인하고 싶은 경우.
• 스킬 출처를 검토해야 하는 메인테이너: 스캔 입력으로 Git 저장소, URL, zip 파일, 디렉터리, 단일 파일을 지원해 다양한 배포 형식을 다룹니다.
• 로컬에 uv가 설치되어 있고, 쓰는 에이전트가 MCP를 지원하며, 스캔을 에이전트가 직접 호출하는 도구로 쓰고 싶은 사람.

적합하지 않거나 주의가 필요한 경우:

• 정적 검사만 수행합니다: 공식 문서는 스캔 대상 스킬을 절대 실행하지 않는다고 명시합니다. 스킬이 실제로 실행될 때의 동작은 검사 범위 밖이며, 스캔을 통과했다고 실행이 안전하다는 뜻이 아닙니다.
• 스킬 패키지 자체를 대상으로 하며, 시스템 권한이나 의존성 공급망 같은 다른 보안 작업을 대체하지 않습니다.
• uv가 없을 때 공식 페이지는 다른 설치 방법을 제시하지 않으며, 사용 가능 여부는 미확인입니다.
• 스캔 판정 기준과 규칙 커버리지는 공식적으로 설명이 없으며, 미확인입니다.

3분 만에 첫 시도하기

공식이 지원하는 가장 직접적인 경로: 먼저 uv로 GitHub 저장소에서 CLI 도구로 설치한 뒤, MCP를 지원하는 로컬 에이전트에서 스캔을 한 번 호출합니다.

사전 조건: 로컬에 uv가 설치되어 있을 것. 에이전트 측이 MCP를 지원할 것.

1단계, 터미널에서 공식 설치 명령을 실행합니다:

uv tool install git+https://github.com/NVIDIA/skillspector.git

부작용 주의: 공식 설명에 따르면 이 프로젝트는 다른 서드파티 오픈소스 소프트웨어를 추가로 내려받아 설치합니다. 수용할 수 있는지 확인한 뒤 실행하세요.

2단계, 스캔을 로컬 에이전트에 연결합니다. 공식 설명에 따르면 MCP 서버 형태로 동작하며, Claude Code, Codex CLI, Gemini CLI 같은 MCP 지원 로컬 에이전트가 스캔을 도구로 호출할 수 있습니다. MCP 서버의 구체적인 등록 방법(설정 파일 위치, 시작 명령과 인자)은 공식 페이지에 적혀 있지 않아 이 글에서 추측하지 않으며, 저장소 내 설명을 기준으로 하세요.

3단계, 저위험 스캔을 한 번 실행합니다. 에이전트에 자연어로 특정 스킬이 있는 디렉터리나 zip 파일을 스캔해 달라고 요청합니다. 예: “이 스킬 디렉터리를 스캔해서 악성 패턴과 보안 위험이 있는지 확인해 줘.” 이는 분석 작업이며, 공식 설명에 따르면 스캔 대상 스킬은 실행되지 않습니다.

성공 신호: 1단계 명령이 오류 없이 끝나는 것. 연결에 성공하면 에이전트가 도구 형태로 스캔을 시작하고 결과를 받을 수 있습니다. 스캔 보고서의 구체적인 형식과 필드는 공식적으로 기술되지 않아 미확인이며, 실제 반환값을 기준으로 하세요.

사용 사례

사례 1: 서드파티 스킬 설치 전 보안 사전 점검. 커뮤니티에서 얻은 스킬 zip을 자신의 에이전트에 넣고 싶습니다. MCP를 지원하는 에이전트에 “스캔 도구로 이 zip 파일을 검사하고 악성 패턴과 보안 위험을 보고해 줘”라고 지시합니다. 에이전트는 스캔 흐름을 호출해 이 zip 파일(공식 지원 입력 유형)을 처리하고 정적 분석 결과를 돌려줍니다. 이를 바탕으로 설치를 계속할지 판단할 수 있습니다. 검사는 실행을 포함하지 않으므로 스킬의 실제 동작은 여전히 스스로 주의해야 합니다.

사례 2: 자신이 관리하는 스킬 저장소 검토. Git 저장소에 두고 관리하는 스킬이 있고, 특정 변경에서 위험한 패턴이 들어왔는지 걱정됩니다. 에이전트에게 그 Git 저장소나 URL을 스캔하게 해 현재 버전에서 발견된 문제를 확인합니다. 입력이 저장소나 URL을 바로 쓰고 수동 패키징이 필요 없으므로, 변경 병합 후나 정기 점검에 적합합니다.

사용 경계

• 파일·명령 접근: 스캔은 정적 분석이며, 공식 문서는 스캔 대상 스킬을 절대 실행하지 않는다고 명시합니다. 임시 파일 작성 여부와 네트워크 접속 여부는 공식 설명이 없어 미확인입니다.
• 설치 부작용: 설치 명령은 서드파티 오픈소스 소프트웨어를 추가로 내려받아 설치합니다. 실행 전 가장 명확한 확인 지점입니다.
• 환경과 클라이언트 전제: uv가 필요합니다. MCP 방식 호출은 MCP를 지원하는 로컬 에이전트를 요구하며, 공식은 Claude Code, Codex CLI, Gemini CLI를 지목했습니다. 다른 에이전트에서 쓸 수 있는지는 미확인이며, 이 세 가지로 한정된다고도 모두 가능하다고도 단정하지 마세요.
• 결과 용도: 스캔 결과는 판단 보조이며, 설치 여부와 처리 방식은 사용자가 결정합니다. 결과를 보안 감사 결론으로 바로 쓸 수 있는지는 공식 설명이 없어 미확인입니다.
• 아직 미확인인 정보: 스캔 보고서 형식, 지원 운영체제, 네트워크 필요 여부 등은 공식 페이지에 언급이 없으므로, 사용 전 저장소의 최신 설명을 기준으로 하세요.