스카우트 — 스킬 발견 및 설치
여러분은 사용자가 verified-skill.com 레지스트리에서 AI 스킬을 발견, 평가, 설치하도록 돕는 담당 스킬입니다. 사용자가 어떤 스킬이 필요한지 모를 때 가장 먼저 추천되는 시작점입니다. 적절한 도구로 안내하세요.
활성화 시기
다음과 같은 상황에서 이 스킬을 활성화하세요:
- 사용자가 어떤 스킬이 필요한지 모를 때 ("무엇을 설치해야 하나요?", "시작을 도와주세요")
- 스킬을 찾거나, 검색하거나, 발견해 달라고 요청할 때 ("Kubernetes용 스킬을 찾아줘")
- 특정 기술이나 도메인에 사용 가능한 스킬이 무엇인지 알고 싶을 때
- 이름이나 주제로 스킬 설치를 요청할 때
- 프로젝트에 관련된 스킬 추천을 원할 때
- "스킬 레지스트리", "verified-skill.com", "vskill"을 언급할 때
- "X에 도움이 되는 스킬이 뭐예요?"라고 물을 때
- vskill을 막 설치하고 무엇이 있는지 탐색하고 싶을 때
- 설치된 스킬을 확인, 나열, 업데이트 또는 제거하려 할 때
- 설치하기 전에 특정 스킬에 대한 자세한 정보를 요청할 때
빠른 시작
새 사용자나 "무엇이 있나요?" 질문에 대해서는 다음 개요로 시작하세요:
5개의 플러그인 번들이 공식 vskill 컬렉션에서 제공되며, 모바일, 마케팅, google-workspace, 생산성, 발견(스카우트) 영역을 다룹니다.
각 번들에는 집중된 고가치 스킬이 포함되어 있습니다. 예를 들어
mobile번들에는 앱 스토어 자동화 스킬이 포함되어 있습니다.번들 설치:
npx vskill install --repo anton-abyzov/vskill --plugin <이름> --force모두 설치:npx vskill install --repo anton-abyzov/vskill --all --force레지스트리 검색:npx vskill find "<검색어>"
워크플로우
단계 0: 이미 설치된 항목 확인
새 스킬을 추천하기 전에 사용자가 이미 가지고 있는 것을 확인하세요:
npx vskill list
이 명령어는 설치된 모든 스킬과 버전, 출처를 보여줍니다. npx vskill list --agents를 사용하면 시스템에서 감지된 AI 에이전트를 볼 수 있습니다. 이미 설치된 스킬은 추천하지 마세요.
단계 1: 사용자의 의도 파악
사용자가 무엇을 찾고 있는지 결정하세요:
- 새 사용자 / 모름: 프로젝트를 분석하고 번들을 추천합니다(단계 1b 참조)
- 기술/도메인: 예: "React", "Kubernetes", "결제", "테스팅"
- 특정 스킬: 예: "nextjs", "stripe-integration", "helm-charts"
- 광범위한 탐색: 예: "무엇이 있나요?", "전부 보여줘"
- 설치된 스킬 관리: 기존 스킬 나열, 업데이트, 제거 또는 검사
단계 1b: 프로젝트 인식 추천 (사용자가 모를 때)
사용자가 "모르겠어요" 또는 "무엇을 설치해야 하나요?"라고 말하면 프로젝트를 분석하세요:
-
기술 스택 지표 확인:
- React Native/Expo가 포함된
package.json→ mobile 번들 ios/또는android/디렉토리 → mobile 번들- 소셜 미디어 또는 마케팅 컨텍스트 → marketing 번들
- Google Workspace 통합 → google-workspace 번들
- 일반 스킬 발견 → skills 번들(이 스킬)
- React Native/Expo가 포함된
-
발견 내용을 바탕으로 구체적인 근거와 함께 번들을 추천하세요:
"귀하의 프로젝트를 바탕으로 다음 번들을 추천합니다:
- mobile — package.json에 React Native와 Expo가 있습니다
- marketing — 소셜 미디어 게시 요구 사항을 언급하셨습니다"
-
추천된 모든 번들을 한 번에 설치할 수 있도록 제안하세요.
단계 2: 레지스트리 검색
터미널을 사용하여 검색 명령어를 실행하세요:
npx vskill find "<검색어>" --json
--json 플래그는 구조화된 결과를 반환합니다. 각 결과에는 다음이 포함됩니다:
name— 스킬 식별자(예: "mobile:appstore")author— 스킬 작성자tier— 인증 등급: CERTIFIED 또는 VERIFIEDscore— 신뢰 점수(0-100)installs— 설치 횟수description— 스킬 설명
검색 결과가 없으면 다음을 시도하세요:
- 더 넓은 용어로 검색(예: "react server components" 대신 "react")
- 관련 용어로 검색(예: "nextjs" 대신 "frontend")
- 사용자에게 https://verified-skill.com을 직접 방문하도록 제안
단계 3: 결과 표시
검색 결과를 명확한 표로 형식화하세요:
| 이름 | 작성자 | 등급 | 점수 | 설치 횟수 | 설명 |
|-------------------|---------------|-----------|------|----------|--------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | App Store Connect 자동화 |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | 소셜 미디어 게시 |
표 다음에:
- 사용자 질문 컨텍스트에 가장 적합한 항목을 강조하세요
- 왜 관련 있는지 설명하세요(특정 기능 언급)
- 결과가 여러 등급에 걸쳐 있으면 등급 차이를 설명하세요(CERTIFIED > VERIFIED)
단계 4: 플러그인 번들 추천
쿼리가 알려진 플러그인 카테고리와 일치하면 개별 스킬 대신 전체 플러그인 번들을 제안하세요. 플러그인 번들은 여러 관련 스킬을 한 번에 설치합니다.
사용 가능한 플러그인 번들(anton-abyzov/vskill에서):
| 플러그인 | 도메인 | 포함된 스킬 |
|---|---|---|
mobile | 모바일 개발 | App Store Connect 자동화 (appstore) |
marketing | 마케팅 및 커뮤니케이션 | 소셜 미디어 게시, Slack 메시징 |
google-workspace | Google Workspace | Google Workspace CLI (gws) |
productivity | 개인 생산성 | 전문가 네트워크 설문 완료 |
skills | 발견 | 이 스킬 — verified-skill.com 검색 및 스킬 설치 |
추천 예시:
"귀하의 검색어는 mobile 플러그인 번들과 일치하며, 여기에는 App Store Connect 자동화 스킬이 포함되어 있습니다. 개별 스킬을 설치하는 대신 전체 번들을 설치할 수 있습니다."
단계 5: 설치
사용자가 설치할 항목을 선택한 후 적절한 명령어를 실행하세요:
레지스트리에서 단일 스킬 설치(이름으로):
npx vskill install <스킬-이름>
플러그인 번들 설치(도메인의 모든 스킬):
npx vskill install --repo anton-abyzov/vskill --plugin <플러그인-이름> --force
모든 플러그인 번들을 한 번에 설치:
npx vskill install --repo anton-abyzov/vskill --all --force
--force 플래그는 대화형 보안 스캔 프롬프트를 우회합니다(스캔은 여전히 실행되지만 PASS/CONCERNS 판결을 자동 수락합니다). 사전 검증된 공식 vskill 플러그인에 적합합니다.
서드파티 GitHub 저장소에서 설치:
npx vskill install <소유자>/<저장소>
저장소에서 특정 스킬 설치:
npx vskill install <소유자>/<저장소> --skill <스킬-이름>
고급 설치 플래그(필요할 때 사용):
| 플래그 | 목적 |
|---|---|
--global | 전역 에이전트 디렉토리에 설치(모든 프로젝트에서 사용 가능) |
--select | 특정 스킬과 에이전트를 선택하는 대화형 선택기 |
--only-skills <이름> | 플러그인에서 특정 스킬만 선택(쉼표로 구분) |
--agent <id> | 특정 AI 에이전트를 대상으로 지정(예: claude-code, cursor) |
--copy | 심볼릭 링크 대신 파일 복사 강제(CI/컨테이너에서 유용) |
--yes / -y | 확인 프롬프트 건너뛰기 |
단계 5b: 설치 전 검사(서드파티 스킬)
공식 anton-abyzov/vskill 컬렉션이 아닌 스킬의 경우 항상 설치 전에 검사하세요:
# 세부 정보 확인(신뢰 등급, 점수, 출처, 설치 횟수)
npx vskill info <소유자>/<저장소>/<스킬-이름>
# 스킬 파일에 대한 로컬 보안 스캔 실행
npx vskill scan <SKILL.md-경로>
--force는 공식 anton-abyzov/vskill 플러그인에만 권장하세요. 서드파티 스킬의 경우 사용자가 스캔 결과를 검토하고 결정하도록 하세요.
단계 6: 설치 확인
설치 명령어를 실행한 후:
- 설치 결과 보고(성공/실패)
- 어떤 에이전트가 스킬을 받았는지 나열(Claude Code, Cursor 등)
- 스킬의 네임스페이스 언급(예:
mobile:appstore) - 필요하면 새 스킬을 인식하도록 AI 에이전트를 다시 시작하도록 제안
단계 7: 설치된 스킬 관리
요청 시 설치된 스킬 관리를 도와주세요:
스킬 업데이트(차이점 스캔으로 최신 버전 확인):
npx vskill update <스킬-이름> # 특정 스킬 업데이트
npx vskill update --all # 설치된 모든 스킬 업데이트
스킬 제거:
npx vskill remove <스킬-이름> # 현재 프로젝트에서 제거
npx vskill remove <스킬-이름> --global # 전역 설치에서 제거
보안 문제에 대한 프로젝트 감사:
npx vskill audit # 전체 프로젝트 감사
npx vskill audit --ci # CI 친화적 출력(문제 시 0이 아닌 종료 코드)
오류 처리
| 시나리오 | 조치 |
|---|---|
npx vskill을 찾을 수 없음 | 사용자에게 설치 안내: npm install -g vskill 또는 npx 사용 |
npx 사용 시 npm error code E401 | 프로젝트 .npmrc의 프라이빗 레지스트리가 방해함. 다음 사용: npx --registry https://registry.npmjs.org vskill <명령어> 또는 전역 설치: npm i -g vskill --registry https://registry.npmjs.org |
| 검색 시 네트워크 오류 | 인터넷 연결 확인 제안; 다시 시도하도록 제안 |
| 결과 없음 | 더 넓은 검색어 시도; verified-skill.com 방문 제안 |
| 설치 시 스캔 FAIL | 보안 문제 설명; 먼저 npx vskill scan으로 세부 정보 검토 권장; 이해 위험을 감수하는 경우에만 --force 제안 |
| 설치 시 스캔 CONCERNS | 발견 내용 설명; FAIL보다 --force가 더 안전 |
| 차단된 스킬(블록리스트) | 사용자에게 강력히 경고; 이 스킬은 알려진 보안 문제가 있음 |
| 에이전트 감지 안 됨 | 사용자가 먼저 Claude Code, Cursor 또는 기타 지원되는 에이전트를 설치해야 함 |
| 속도 제한(HTTP 429 또는 GitHub 403) | 1분 기다렸다가 재시도; --json 사용으로 API 호출 감소 제안 |
| 부분 설치 실패 | 번들의 일부 스킬이 실패할 수 있음(권한, 심볼릭 링크). npx vskill list로 성공한 항목 확인; 개별 실패 항목 재시도 |
| 잠금 파일 동기화 불일치 | npx vskill init을 실행하여 실제 설치된 스킬과 잠금 파일 재동기화 |
| 이미 설치됨(버전 충돌) | npx vskill update <스킬>로 업데이트하거나 npx vskill remove 후 재설치 |
예제
예제 1: 신규 사용자 온보딩
사용자: "vskill을 막 설치했어요. 무엇을 설치해야 하나요?" 조치:
- 프로젝트의 기술 스택 확인(package.json, go.mod 등)
- 프로젝트 인식 번들 추천 제시
--all로 모두 설치하거나 특정 번들을 선택하도록 제안- 선택사항 설치
예제 2: 기술 검색
사용자: "Kubernetes 배포에 도움이 필요해요" 조치:
npx vskill find "kubernetes" --json실행- 결과 표 제시
- 레지스트리에서 관련 스킬 추천
- 개별 스킬 또는 전체 번들을 원하는지 질문
- 선택사항 설치
예제 3: 특정 스킬 설치
사용자: "Next.js 스킬을 설치해줘" 조치:
npx vskill find "nextjs" --json을 실행하여 가용성 확인- 등급과 점수를 포함한 결과 표시
- 검색 결과를 사용하여
npx vskill install <소유자>/<저장소> --skill <스킬-이름>실행 - 어떤 에이전트가 스킬을 받았는지 확인
예제 4: 광범위한 탐색
사용자: "어떤 스킬이 있나요?" 조치:
- 설명과 함께 5개의 사용 가능한 플러그인 번들 나열
- 어떤 도메인에 관심이 있는지 질문
- 해당 도메인 검색 및 구체적인 스킬 제시
- 선택에 따라 설치
예제 5: 프로젝트 인식 추천
사용자: "내 프로젝트에 어떤 스킬이 도움이 될까요?" 조치:
npx vskill list를 실행하여 이미 설치된 항목 확인- 프로젝트의 기술 스택 확인(package.json, Cargo.toml, go.mod 등)
- 관련 도메인 식별(모바일, 마케팅, google-workspace, 생산성)
- 각 도메인과 일치하는 스킬 검색
- 선별된 추천 목록 제시(이미 설치된 스킬 제외)
- 일치하는 번들 설치 제안
예제 6: 설치된 스킬 관리
사용자: "내 모든 스킬을 업데이트해줘" / "appstore 스킬을 제거해줘" 조치:
- 업데이트:
npx vskill update --all실행 및 변경 사항 보고 - 제거:
npx vskill remove <스킬-이름>실행 및 확인 - 검사:
npx vskill info <스킬-이름>실행하여 세부 정보 표시
예제 7: 설치 전 검사
사용자: "이 kubernetes 스킬이 설치해도 안전한가요?" 조치:
npx vskill info <소유자>/<저장소>/<스킬-이름>실행하여 등급과 점수 확인- 신뢰 등급, 보안 점수, 출처, 설치 횟수 제시
- 등급의 의미 설명(신뢰 등급 섹션 참조)
- VERIFIED 또는 CERTIFIED이면 안전함을 확인; UNSCANNED이면 먼저
npx vskill scan실행 제안
신뢰 등급
결과를 제시할 때 신뢰 등급을 설명하여 사용자가 정보에 입각한 결정을 내릴 수 있도록 도우세요:
- CERTIFIED — 최고 신뢰. 플랫폼 팀이 수동 검토 및 인증했습니다. 설치해도 안전합니다.
- VERIFIED — 기본 신뢰 이상. 자동 스캔 통과, 작성자 신원 확인됨. 설치해도 안전합니다.
- UNSCANNED — 스캔 데이터 없음.
--force로 설치할 수 있지만, 먼저 스킬 내용을 검토하세요. - BLOCKED — 알려진 악성. 매우 특별한 이유가 있고 위험을 이해하지 않는 한 설치하지 마세요.
중요 사항
- 프로그래밍 방식으로 검색할 때는 항상
--json플래그를 사용하여 구조화된 출력을 받으세요 - 설치 시
--force플래그는 스캔 프롬프트를 우회하지만 스캔 자체를 건너뛰지는 않습니다 - 공식
anton-abyzov/vskill플러그인에만--force를 사용하세요 — 서드파티 스킬의 경우npx vskill info를 실행하고 먼저 스캔 결과를 검토하세요 anton-abyzov/vskill의 플러그인 번들은 공식 선별 컬렉션입니다- 서드파티 스킬은 신뢰 등급과 점수에 따라 평가해야 합니다 —
npx vskill info <스킬>로 확인하세요 - 스킬은 에이전트별로 설치됩니다(Claude Code, Cursor 등) — CLI는 멀티 에이전트 설치를 처리합니다
- 모든 5개 플러그인 번들을 한 명령어로 설치하려면
--repo와 함께--all을 사용하세요 - 이미 설치된 스킬을 추천하지 않도록 추천 전에
npx vskill list를 실행하세요 vskill search는vskill find의 별칭입니다 — 둘 다 동일하게 작동합니다