Claude Skills Registry – 무엇인가요

Claude-Code "스킬"(Claude가 호출할 수 있는 재사용 가능한 코드 스니펫, 도구 및 에이전트)의 공개적이고 검색 가능한 카탈로그입니다. 이 프로젝트는 세 개의 연결된 저장소로 구성됩니다.

• claude-skill-registry-core – 스킬 소스를 크롤링하고, 검증하며, 인덱스와 정적 사이트를 빌드하는 권한 있는 파이프라인.
• claude-skill-registry-data – 개별 스킬 디렉토리(skills/**)의 원시 아카이브.
• claude-skill-registry – 핵심 로직, 데이터 및 다운스트림 사용을 위한 사전 빌드된 JSON 아티팩트를 번들로 제공하는 생성된 미러.

이 레지스트리는 자체적으로 스킬을 제공하지 않습니다; 단지 인덱싱하고 설명하며, 원본 저장소 및 라이선스로 연결할 뿐입니다.

---

왜 중요한가요

Claude-Code 에이전트는 커뮤니티가 기여한 기능(예: PDF 파싱, 테스트 자동화, DevOps 도우미)을 발견할 방법이 필요합니다. 이 레지스트리는 다음을 제공합니다.

• 빠른 클라이언트 측 검색 – 브라우저나 CLI에서 로드할 수 있는 gzipped JSON 인덱스.
• 메타데이터 및 품질 신호 – 별점, 보안 스캔 결과, 카테고리 태그 및 설치 경로.
• 다양한 사용 방법 – 웹 UI, Go 기반 CLI (sk), 원시 JSON API.

---

사용 방법

방법	제공 내용	퀵 스타트
웹 UI	대화형 검색 페이지 (GitHub Pages).	https://majiayu000.github.io/claude-skill-registry/ 열기
CLI (sk)	터미널 기반의 단일 스킬 검색 및 설치.	```bash
go install github.com/majiayu000/claude-skill-manager@latest

sk로 이름 변경 후 $PATH에 있는지 확인

sk search testing # 스킬 찾기 sk install anthropics/skills/skills/docx # 설치하기

| **JSON API** | 전체 인덱스, 카테고리 샤드, 품질/보안 순위 등의 직접 다운로드. | ```bash
curl https://majiayu000.github.io/claude-skill-registry/search-index-lite.json
# 또는 매니페스트 및 개별 샤드 파일 가져오기
``` |

스킬을 설치하기로 결정했다면, 항목에 표시된 **소스 링크를 따르고** 원본 라이선스를 존중하십시오. 레지스트리는 스킬을 가리킬 뿐이며, 콘텐츠를 재라이선스하지 않습니다.

---
## 아키텍처 개요

데이터 수집 (core) → 인덱스 생성 (core) → 사용 (Web UI, sk CLI, JSON API)

* **레이어 1 – 데이터 수집** – GitHub 크롤러가 스킬 저장소를 발견하고, 파일을 다운로드하며, 보안 스캐너를 실행합니다.
* **레이어 2 – 인덱스 생성** – 스크립트가 여러 JSON 아티팩트를 생성합니다:
  * `search-index.json` (전체 검색 가능 인덱스)
  * `search-index-lite.json` (빠른 클라이언트 측 사용을 위한 압축 버전)
  * 카테고리 매니페스트, 품질, 보안 및 순위 인덱스.
* **레이어 3 – 사용** – 생성된 파일은 GitHub Pages, `sk` Go 바이너리 또는 원시 HTTP 엔드포인트를 통해 제공됩니다.

**핵심 저장소**는 모든 파이프라인 코드(`scripts/`, `sources/`, `taxonomy/`)를 보유합니다. **데이터 저장소**는 실제 `skills/**` 트리를 저장합니다. **메인(미러) 저장소**는 다운스트림 사용자를 위해 두 저장소를 번들로 묶어 매일 생성되는 아티팩트입니다.

---
## 시작하기 (개발자용)

1. **핵심 저장소 클론** (파이프라인의 진실된 소스):
   ```bash
   git clone --filter=blob:none --sparse https://github.com/majiayu000/claude-skill-registry-core.git
   cd claude-skill-registry-core
   git sparse-checkout set --cone docs scripts sources schema

2. Python 환경 설정 (uv 사용):

   uv venv && source .venv/bin/activate
   uv pip install -r requirements.txt
   

3. 로컬에서 검색 인덱스 빌드 (선택 사항, 변경 사항 테스트용):

   python scripts/build_search_index.py --registry registry.json --output docs
   

4. 로컬에서 웹 UI 실행:

   cd docs && python -m http.server 8000
   # http://localhost:8000 방문
   

5. 새 스킬 제출 – "Add Skill" 템플릿으로 이슈를 열거나, 핵심 저장소의 sources/community.json에 JSON 항목을 PR하십시오.

---

로드맵 하이라이트

• ✅ 매일 자동 업데이트, 보안 스캔 및 웹 UI가 라이브 상태입니다.
• ✅ 경량 gzipped 검색 인덱스를 사용할 수 있습니다.
• 계획 중: 벡터 기반 의미론적 검색, 스킬 추천 엔진, 버전 추적, 품질 점수 매기기 및 API 속도 제한.

---

라이선스

레지스트리 코드 및 파이프라인은 MIT License 하에 릴리스됩니다 (LICENSE 참조).

개별 스킬은 원본 라이선스를 유지합니다; 레지스트리는 타사 콘텐츠를 재라이선스하지 않습니다.

---

관련 생태계

이 레지스트리는 Claude-Code 및 기타 LLM 에이전트를 위한 더 넓은 "에이전트 인프라 스택"의 일부입니다:

레이어	프로젝트	역할
확장	claude-skill-registry	커뮤니티 스킬 발견 및 탐색
확장	spellbook	크로스 런타임 스킬 번들
신뢰	argus	공급망 보안 스캐너
신뢰	vibeguard	에이전트용 런타임 가드레일
기억	remem	지속적인 로컬 메모리
오케스트레이션	harness	Rust 기반 에이전트 오케스트레이션
라우팅	litellm‑rs	고성능 LLM 게이트웨이
유지	keepline	세션 모니터링 및 복구

---

요약

Claude Skills Registry는 커뮤니티가 기여한 Claude-Code 플러그인의 유지 관리되는 검색 가능한 인덱스입니다. 웹 UI, Go CLI (sk), 원시 JSON API를 제공하며, 이 모든 것은 스킬 저장소를 크롤링하고 검증하며 매일 업데이트를 게시하는 자동화 파이프라인에서 빌드됩니다. 이 프로젝트는 AI/LLM 도구 범주에 완전히 속하며 MIT 라이선스 하에 오픈 소스로 제공됩니다.