새 AI 에이전트 Skill을 설치할 때, 이름과 설명만 보고 파일을 믿어도 될까요? NVIDIA SkillSpector는 설치 전에 Skill 파일을 읽어 위험 패턴을 찾는 보안 스캐너입니다. 프롬프트 인젝션이나 데이터 유출처럼 문장만으로는 놓치기 쉬운 신호를 정적 분석하고, 원하면 LLM으로 문맥도 살펴봅니다.
다만 ‘스캔했다’는 말의 범위를 정확히 알아야 합니다. SkillSpector는 분석 대상 Skill을 실행하지 않지만, 설치 후 그 Skill을 격리하는 호스트 샌드박스는 아닙니다. 어떤 분석이 동작하고 검사 중 어디로 데이터가 나가는지부터 살펴보겠습니다.
SkillSpector가 설치 전에 살펴보는 것
Git 저장소와 URL, ZIP 파일, 디렉터리, 단일 파일을 입력으로 받을 수 있습니다. 기본 검사는 정규식 기반 패턴 탐지, Python AST 분석, YARA 시그니처 검사와 의존성 취약점 조회를 조합합니다. 위험한 코드 호출이나 프롬프트 인젝션, 권한 상승, 데이터 유출 패턴, 알려진 취약 의존성처럼 여러 종류의 신호를 확인합니다.
검사 대상 Skill의 코드를 실행하는 동적 분석은 아닙니다. 파일의 내용과 구조에서 의심스러운 흔적을 찾는 정적 분석이므로, 결과는 설치 판단에 필요한 단서로 읽는 편이 맞습니다. 보고서는 터미널에서 보거나 JSON·Markdown·SARIF 형식으로 저장할 수 있습니다.
빠른 패턴 검사와 선택형 LLM 분석
분석은 두 단계로 나뉩니다. 첫 단계의 정적 검사는 빠르게 규칙과 코드 구조를 살핍니다. 두 번째 단계는 선택형 LLM 의미 분석입니다. Skill이 무엇을 하겠다고 설명하는지와 실제 파일이 하는 일을 비교하는 등, 단순 패턴만으로 판단하기 어려운 맥락을 검토하는 데 쓰입니다.
저장소의 기본 구성에서는 LLM 분석이 켜져 있습니다. 이때 분석 대상 파일 내용은 설정된 provider endpoint로 전송됩니다. OpenAI, Anthropic, NVIDIA 제공 endpoint, Ollama 등은 저장소에 문서화된 provider 설정 예시가 있으니, 사용하려는 환경과 설정 항목을 공식 README에서 확인하세요. 파일 내용을 외부 LLM에 보내지 않고 정적 분석만 하려면 다음처럼 실행할 수 있습니다.
skillspector scan ./my-skill/ --no-llm--no-llm은 LLM 콘텐츠 분석을 끄는 옵션입니다. 그러나 네트워크 조회까지 모두 끄는 것은 아닙니다. SC4 공급망 검사는 Skill이 선언한 의존성의 이름과 버전을 OSV.dev에 보내 알려진 취약점을 조회합니다. 공식 문서에 따르면 OSV.dev에 연결할 수 없으면 내장된 제한적 목록으로 대체됩니다.
직접 실행해 보는 방법
공식 안내는 Python 가상환경을 만든 뒤 저장소에서 설치하는 흐름을 제공합니다. uv를 사용할 수 있다면 아래처럼 준비합니다.
git clone https://github.com/NVIDIA/SkillSpector.git
cd SkillSpector
uv venv .venv && source .venv/bin/activate
make install설치 후에는 로컬 디렉터리, 단일 SKILL.md, Git 저장소 또는 ZIP 파일을 검사할 수 있습니다. 예를 들어 공개 저장소를 바로 살펴보려면 다음처럼 실행합니다.
skillspector scan https://github.com/user/my-skill
skillspector scan ./SKILL.md --format json --output report.json첫 명령은 기본 분석을, 둘째 명령은 파일을 검사하고 JSON 보고서를 저장하는 예입니다. CI나 코드 검토 흐름에 붙일 때는 JSON 또는 SARIF 출력을 선택할 수 있습니다. 입력 자체를 신뢰하기 어려운 환경이라면 Docker 실행 방법도 README에 나와 있습니다. 다만 컨테이너를 사용한다고 해서 검사 결과가 Skill의 향후 실행을 격리해 주는 것은 아닙니다.
결과를 설치 결정에 연결하기
보고서의 위험 점수와 권고는 발견된 신호를 빠르게 정리하는 데 도움이 됩니다. 높은 점수나 심각도 항목은 해당 파일과 코드 경로를 직접 확인하고, Skill이 요청하는 권한과 실제 동작이 필요한 범위인지 검토하세요. 반대로 낮은 점수도 모든 공격이나 실행 시 동작을 확인했다는 뜻은 아닙니다. SkillSpector는 정적 분석 중심이며 이미지 안의 텍스트, 암호화·바이너리 코드, 실행 중에만 드러나는 행동은 놓칠 수 있다고 문서에서 밝힙니다.
에이전트 도구를 실제로 운영하는 구조와 설치 후 권한 경계를 함께 이해하려면 Grok Bot Primary Bot의 에이전트 작업 위임 방식도 참고할 만합니다. Skill 설치와 활용 사례는 Matt Pocock Chief of Staff Skill 소개에서 이어서 볼 수 있습니다.
정리하면 SkillSpector는 AI 에이전트 Skill을 설치하기 전에 정적 규칙 검사와 선택형 LLM 분석으로 위험 신호를 살펴보는 도구입니다. 기본 LLM 분석은 파일 내용을 설정 endpoint로 전송하고, LLM을 꺼도 선언된 의존성 좌표는 OSV.dev 조회에 사용됩니다. 검사 결과를 검토 절차의 한 단계로 활용하되, 설치 후 격리나 안전 보장으로 해석하지 않는 것이 핵심입니다.
