foryourhealth111-pixel/Vibe-Skills

VibeSkills – AI 에이전트 스킬을 위한 오케스트레이터

개요

• 언어 모델 기반 에이전트와 로컬에 설치된 스킬（재사용 가능한 도구 래퍼, 스크립트, 또는 워크플로우）컬렉션 사이에 위치하는 범용 “스킬” 매니저입니다.
• 그 역할은 주어진 복잡한 작업에 적합한 스킬의 하위 집합을 계획, 선택, 순서화하고 최종 결과물을 검증하는 것입니다.

중요성

• 많은 AI 에이전트 프레임워크에서는 사용자가 모델에 어떤 도구를 호출할지 수동으로 지시해야 하거나, 모델이 설치된 도구의 방대한 라이브러리를 헤매게 됩니다.
• VibeSkills는 다음 방법으로 이러한 마찰을 줄입니다:
  1. 작업을 명확히 하고 구체적인 계획으로 전환합니다.
  2. 사용 가능한 로컬 스킬을（SKILL.md 메타데이터를 읽어）발견합니다.
  3. 각 하위 작업에 실제로 관련된 스킬만 후보로 좁힙니다.
  4. 종속성을 고려한 순서로 오케스트레이션합니다（“L” 또는 “XL” 워크플로우 레벨）.
  5. 각 단계 후 검사를 실행하고 전달 전에 최종 검증을 수행합니다.

작동 방식

단계	내용
1. 요구 사항 확인	작업을 시작하기 전에 목표, 제약 조건, 예상 출력에 대한 명확한 진술을 사용자가 승인하도록 요청합니다.
2. 레벨 추천	작업 규모와 종속성에 따라 L（단일 스레드, 관리 가능）또는 XL（병렬 가능, 더 큼）워크플로우를 제안합니다.
3. 스킬 정리	구성된 스킬 폴더를 스캔하고 각 SKILL.md를 읽은 다음 개별 작업 단위에 가장 적합한 스킬을 할당합니다.
4. 실행 및 기록	기본 에이전트가 계획을 실행하며, 코드 작업에는 선택적으로 테스트 주도 개발을 사용합니다. 모든 성공, 실패 및 차단된 단계가 기록됩니다.
5. 결과 확인	검증 가능한 검사（예: 필수 파일, 데이터 계약, 재현성）가 실행되며, 충족되지 않은 검사는 최종 승인을 차단합니다.

데모 사례 – 머신러닝 실험

• 저장소에는 재현 가능한 분류 실험을 생성하는 작업이 완료된 전체 엔드투엔드 실행이 나와 있습니다.
• 100개 이상의 설치된 스킬에서 VibeSkills는 7개를 선택하여 5개의 작업 그룹과 10개의 작업 단위로 구성하고 17개의 검증 검사를 수행했습니다. 모든 검사가 통과되어 데이터 감사, 통계 검토, 그림, 과학 보고서 및 슬라이드 덱이 생성되었습니다.

성능 주장

• SkillsBench（에이전트가 스킬을 얼마나 잘 사용하는지 측정하는 스위트)에서 벤치마크한 결과, VibeSkills v4.1.0은 평균 검증 보상을 +21.12퍼센트 포인트 높이고 총 토큰 사용량을 -29.6% 줄였으며 도구 호출을 -33.1% 줄였습니다（VibeSkills를 사용하지 않는 기준선과 비교）.
• 개선은 더 많은 도구를 호출하는 것이 아니라 더 나은 계획과 선택적 스킬 사용에서 비롯됩니다.

설치 및 빠른 시작

• “VibeSkills 설치” 버튼을 클릭하면 짧은 설치 가이드（docs/install/README.en.md）로 연결됩니다.
• 설치 후 빠른 시작 가이드를 따라 요구 사항 확인, 레벨 선택 및 VibeSkills의 작업 오케스트레이션을 실행할 수 있습니다.

대상 사용자

• 재사용 가능한 AI 도구 래퍼의 대규모 라이브러리를 유지하고 에이전트가 자동으로 올바른 것을 선택하도록 하려는 연구원이나 엔지니어.
• 복잡한 다단계 출력을 제공하면서 토큰 소비를 낮게 유지해야 하는 AI 어시스턴트 제품을 구축하는 팀.
• 작업에서 도구로의 수동 매핑에 대한 인지 부하를 줄이려는 모든 사람.

더 알아보기

• 자세한 벤치마크 데이터와 재현 지침은 링크된 vibeskills-벤치마크 저장소에 있습니다.
• 저장소에는 사례 연구（docs/cases/ml-experiment/）와 하네스 워크플로우의 시각적 개요가 포함되어 있습니다.

---

VibeSkills는 본질적으로 로컬 스킬 라이브러리의 “관리자”로, 모호한 사용자 요청을 구체적이고 검증 가능하며 토큰 효율적인 실행 계획으로 전환합니다.