/ 오픈소스 / Vibe-Skills

Vibe-Skills

Vibe-Skills는 250개 이상의 로컬 AI 에이전트 스킬 라이브러리를 자동으로 라우팅하고 조정하는 오케스트레이션 스킬로, 작업 계획 및 전달 검증 기능이 내장되어 있습니다.

PythonApache-2.0skill
⭐ GitHubhttps://github.com/foryourhealth111-pixel/Vibe-Skills
2,597
스타 수
+0
스타 증가율
2026년 8월 3일
최근 업데이트
4
클릭 수

1. 프로젝트 개요

Vibe-Skills(VibeSkills)는 대규모 로컬 "스킬" 라이브러리를 자동으로 발견, 라우팅, 조정하는 범용 오케스트레이션 스킬로, AI 코딩 에이전트가 개발자가 모든 하위 작업에 적합한 도구를 수동으로 선택하지 않아도 복잡한 다단계 작업을 계획, 실행, 검증할 수 있게 해줍니다.

2. 배경 및 포지셔닝

"에이전트 스킬" 생태계(Claude Code Skills, Codex 스타일 하네스, 유사한 에이전트 프레임워크)가 성장하면서 개발자들은 데이터 과학부터 보안 검토, 문서 작성까지 다양한 개별 스킬을 수십 개에서 수백 개까지 로컬에 설치하게 되었습니다. 어떤 스킬을 어떤 순서로 호출할지, 결과가 요청 사항과 실제로 일치하는지 어떻게 확인할지 기억하는 것 자체가 또 하나의 관리 문제가 되었습니다.

Vibe-Skills는 이러한 메타 문제를 해결하기 위해 만들어졌습니다. 하나의 특수 목적 스킬이 아니라 나머지 라이브러리 위에 위치하는 라우터이자 오케스트레이터 역할을 합니다. 사용자와 먼저 요구 사항을 확인하고, 작업 규모를 추정하며, 각 작업 모듈에 관련된 스킬을 추려내고, 세션 전반에 걸쳐 실행 상태를 추적하며, 계획된 내용과 실제 전달된 내용을 비교하는 수용 보고서를 생성합니다.

이는 단순히 독립적인 단일 목적 스킬의 폴더에 불과한 일반적인 스킬 컬렉션과 달리, Vibe-Skills는 워크플로 레이어(작업 계획, 전체 라이브러리를 컨텍스트에 로드하지 않는 스킬 검색, 세션 간 진행 상황 유지, 작업 완료로 간주되기 전의 공식 검증 단계)를 추가합니다. 또한 250개 이상의 커뮤니티 스킬이 번들로 포함되어 있어 오케스트레이터와 즉시 사용 가능한 스킬 팩으로 모두 활용할 수 있습니다.

3. 기능 카테고리

  • 🧭 오케스트레이션 코어 — 요구 사항 확인, 복잡성 평가(--l / --xl), 스킬 할당, 실행 추적을 담당하는 엔진입니다. 예시: core/skill-contracts, agents/ 계획 템플릿, protocols/ 통신 사양, 다양한 호스트 애플리케이션용 adapters/. 목적: 자연어 요청을 조정되고 감사 가능한 계획으로 전환합니다.
  • 🔬 과학 및 데이터 스킬 — 가장 큰 번들 카테고리로, 생물정보학, 통계, ML 연구를 다룹니다. 예시: biopython, astropy, rdkit, scanpy, pymc-bayesian-modeling, scikit-learn, pytorch-lightning. 목적: 과학 컴퓨팅 및 데이터 분석 작업에 도메인별 전문성을 에이전트에게 제공합니다.
  • 🛡️ 보안 및 품질 스킬 — 검토 및 강화 도구입니다. 예시: security-reviewer, security-best-practices, security-threat-model, security-ownership-map, code-reviewer. 목적: 에이전트 주도 개발 중 취약점을 포착하고 코드 품질 게이트를 적용합니다.
  • 📝 문서화 및 작성 스킬 — 콘텐츠 및 기술 문서 작성 도우미입니다. 예시: docs-write, docs-review, writing-plans, scientific-writing, markdown-mermaid-writing. 목적: 일관되고 고품질의 문서 산출물을 생성하고 유지 관리합니다.
  • ⚙️ DevOps 및 배포 스킬 — 통합 및 배포 도우미입니다. 예시: netlify-deploy, vercel-deploy, skypilot-multi-cloud-orchestration, mcp-integration, gh-fix-ci. 목적: 에이전트 워크플로에서 직접 배포 및 인프라 작업을 자동화합니다.
  • 📊 시각화 및 보고 스킬 — 차트 및 보고서 생성 도구입니다. 예시: creating-data-visualizations, matplotlib, plotly, scientific-slides, report-generator. 목적: 원시 분석 결과를 발표 가능한 산출물로 전환합니다.

4. 주요 특징

  • 작업 시작 전 요구 사항 확인 — 오케스트레이터가 사전에 사용자와 범위 및 제약 조건을 명확히 하여 작업 오해로 인한 낭비를 줄입니다.
  • 컨텍스트 효율적인 스킬 검색 — 구성된 폴더의 SKILL.md 파일을 스캔하여 250개 이상의 전체 스킬 라이브러리를 모델의 컨텍스트 창에 로드하는 대신 관련 후보만 추려냅니다.
  • 세션 연속성session_root 폴더가 입력, 진행 상황, 결정 사항을 유지하므로 다단계 작업을 다시 시작하는 대신 이어서 진행할 수 있습니다.
  • 공식 전달 검증delivery-acceptance-report가 승인된 작업 계획(module-work-plan.json)과 실제 실행(module-execution.json)을 비교하여 통과, 실패 또는 차단된 항목을 표시합니다.
  • 복잡성 인식 워크플로 레벨--l--xl 플래그를 통해 사용자가 작업 범위를 알릴 수 있으며 오케스트레이터가 이에 따라 계획 깊이를 조정합니다.
  • 즉시 사용 가능한 250개 이상의 번들 스킬 — 과학, 보안, DevOps, 문서화 등을 아우르며 직접 사용하거나 오케스트레이터를 통해 사용할 수 있습니다.

5. 역할별 사용 사례

  • 일반 개발자: $vibe / /vibe를 사용하여 느슨한 기능 요청을 범위가 지정된 계획으로 전환하고, 적절한 번들 스킬(코드 검토, 문서, 테스트)이 자동으로 적용되도록 한 후 마지막에 검증 보고서를 받아보세요.
  • DevOps/SRE: 오케스트레이터가 조정하는 배포 중심 스킬(netlify-deploy, vercel-deploy, skypilot-multi-cloud-orchestration)을 활용하여 다단계 릴리스 또는 인프라 작업을 수행하세요.
  • 보안 엔지니어: security-reviewer, security-threat-model, security-ownership-map을 통해 검토 작업을 라우팅하고, 오케스트레이터가 어떤 검사가 통과되었는지 또는 차단되었는지 추적하게 하세요.
  • 데이터/연구 과학자: 각 도구의 호출 방법을 개별적으로 기억할 필요 없이 대규모 과학 컴퓨팅 스킬 카탈로그(biopython, astropy, pymc, scikit-learn 등 수십 개)에 접근하세요.
  • 프로젝트 관리자: 계획 및 수용 보고서 산출물(module-work-plan.json, delivery-acceptance-report.md)을 요청 사항 대비 전달 사항의 가벼운 감사 추적으로 활용하세요.

6. 시작하기

필요한 것 찾기bundled/skills/ 아래의 번들 카탈로그를 탐색하거나 docs/quick-start.en.md에서 사용 가능한 기능 개요를 확인하세요.

설치 / 통합 — 게시된 릴리스 아카이브(원시 저장소 체크아웃 아님)를 다운로드한 후 스킬 디렉토리에 설치하세요:

# Windows
./update.ps1 -SkillsDir <skills-dir>

# macOS / Linux
./update.sh --skills-dir <skills-dir>

AI 애플리케이션의 스킬 진입점에서 호출하세요:

$vibe

또는

/vibe

기여하기CONTRIBUTING.md를 읽고, references/contributor-zone-decision-table.md의 영역 표와 references/change-proof-matrix.md의 증명 매트릭스를 확인한 후, 변경 유형에 대한 문서화된 증거 요구 사항을 준수하여 풀 리퀘스트를 여세요.

7. 프로젝트 구조

Vibe-Skills/
├── core/            # 오케스트레이션 엔진 및 스킬 계약
├── agents/          # 계획 템플릿
├── adapters/        # 호스트 애플리케이션용 통합 인터페이스
├── protocols/        # 컴포넌트 간 통신 사양
├── commands/        # CLI 진입점
├── bundled/skills/  # 250개 이상의 즉시 사용 가능한 커뮤니티 스킬
├── docs/            # 아키텍처, 거버넌스, 설치 및 빠른 시작 가이드
├── tests/           # 검증 스위트
├── update.sh / update.ps1   # 설치/업데이트 스크립트
└── check.sh / check.ps1     # 설치 검증

핵심 파일: SKILL.md(오케스트레이터 자체의 스킬 정의), CONTRIBUTING.md(기여 규칙), docs/quick-start.en.md(시작 가이드).

8. 관련 생태계

Vibe-Skills는 Claude Code 및 유사한 에이전트 프레임워크와 같이 로컬 "스킬" 개념을 지원하는 AI 코딩 하네스 내에서 실행되도록 설계되었습니다. 많은 번들 스킬이 해당 도메인의 잘 알려진 오픈소스 라이브러리를 래핑하거나 보완합니다. 예를 들어 과학 컴퓨팅 분야의 scikit-learn, pytorch-lightning, matplotlib, biopython과 Model Context Protocol 서버 연결을 위한 mcp-integration이 있습니다.

9. 라이선스

Apache License 2.0에 따라 라이선스가 부여됩니다.

  • ✅ 상업적 사용, 수정, 배포 및 개인 사용이 허용됩니다.
  • ✅ 저작자 표시가 유지되는 한 수정된 버전을 자체 프로젝트의 일부로 서브라이선스할 수 있습니다.
  • ❌ 어떠한 보증도 제공되지 않으며, 사용으로 인한 손해에 대해 저자는 책임을 지지 않습니다.
  • ℹ️ 타사 구성 요소는 NOTICETHIRD_PARTY_LICENSES.md에 별도로 명시되어 있습니다. 번들 스킬 라이브러리를 재배포하는 경우 해당 파일을 검토하세요.

10. FAQ

Q: 저장소를 클론하여 설치하나요?
A: 아닙니다. 문서는 게시된 릴리스 아카이브에서 설치하도록 지정하며, 원시 저장소 체크아웃이 아닙니다. docs/quick-start.en.md를 참조하세요.

Q: 설치 후 Vibe-Skills를 어떻게 호출하나요?
A: AI 애플리케이션의 스킬 진입점을 통해 호출하며, 일반적으로 $vibe 또는 /vibe입니다. 예: "이 요구 사항을 명확히 하고 계획으로 전환해 줘 $vibe".

Q: --l--xl 플래그는 무엇을 의미하나요?
A: 오케스트레이터에게 작업의 예상 범위를 알려줍니다. --l은 관리 가능한 작업, --xl은 더 크고 복잡한 프로젝트를 의미하므로 이에 따라 계획을 수립합니다.

Q: 업데이트 후 설치가 온전한지 어떻게 확인하나요?
A: check.sh(Windows에서는 check.ps1)를 실행하여 설치 관리자가 관리하는 파일이 존재하고 변경되지 않았는지 확인하세요.

Q: 오케스트레이터 없이 번들 스킬을 사용할 수 있나요?
A: 네. bundled/skills/ 아래의 각 스킬은 자체 SKILL.md가 있는 독립적인 폴더이며 독립적으로 사용할 수 있습니다.

11. 빠른 링크

12. 요약

Vibe-Skills는 성장하는 에이전트 스킬 생태계에서 실제로 겪는 문제점, 즉 설치된 많은 도구 중 어떤 것을 어떤 순서로 사용할지, 결과가 실제로 요구 사항을 충족했는지 아는 문제를 해결합니다. 과학, 보안, DevOps, 문서화를 아우르는 250개 이상의 스킬 번들 라이브러리와 결합하여 대규모 스킬 라이브러리를 운영하는 팀을 위한 오케스트레이션 레이어와 수동 도구 선택 없이 광범위한 기능을 원하는 개별 개발자를 위한 즉시 사용 가능한 툴킷으로서 모두 가치가 있습니다.