anbeime/skill

🎯 Skill Store란?

Skill Store는 AI 에이전트의 "스킬" – AI 에이전트가 수행할 수 있는 작업(예: PPT 생성, 논문 분석, 전자상거래 파이프라인 실행, 음성 합성 등)에 대한 재사용 가능하고 자족적인 설명 – 의 선별된 저장소입니다.

이 프로젝트는 커뮤니티 관리 awesome-agent-skills 컬렉션에서 최신 공식 스킬 182개를 자동으로 가져오고, 관리자가 만든 엄선된 중국어 스킬 63개를 추가합니다. 모든 스킬은 JSON/CSV 파일로 저장되며 로컬 또는 라이브 웹 UI(https://skill.vercel.app)에서 탐색할 수 있습니다.

핵심 아이디어

• 스킬 = 작은 선언형 플러그인 – AI 모델에게 특정 작업을 수행하는 방법과 기대되는 입력/출력을 알려줍니다.
• 중앙 카탈로그 – 개발자가 일반적인 워크플로(문서 처리, 비디오 제작, 전자상거래 자동화 등)에 대해 바퀴를 재발명할 필요가 없습니다.
• 자동 동기화 – GitHub Action이 24시간마다 실행되어 업스트림 awesome-agent-skills 저장소를 크롤링하고 로컬 JSON 파일을 업데이트합니다.
• 내보내기 및 분석 – 데이터를 JSON 또는 CSV로 덤프하여 다운스트림 도구나 연구에 사용할 수 있습니다.

---

⚙️ 시작하기

# 1. 저장소 클론
git clone https://github.com/anbeime/skill.git
cd skill

# 2. Python 의존성 설치
pip install -r requirements.txt

# 3. 업데이트 실행 (일회성 또는 데몬으로)
python main.py --once          # 일회성 새로고침
python main.py --daemon        # 백그라운드 24시간 업데이터

# 4. 카탈로그 확인
cat data/skills.json          # 공식 스킬
cat data/local_skills.json    # 로컬 작성 스킬

main.py 스크립트는 다음도 지원합니다:

• --stats – 카테고리별 개수 요약 출력
• --export <file> – 카탈로그를 CSV로 작성
• -v로 상세 로깅

---

📚 내부 구성?

공식 스킬 (182개)

최고 수준의 팀(Anthropic, Vercel, Cloudflare, Hugging Face, Google Labs 등)에서 제공하며 다음과 같은 도메인을 다룹니다:

• 문서 처리 (docx, pdf, xlsx, pptx)
• 코드 리뷰 및 보안 도구
• 모델 훈련 및 데이터셋 처리
• 클라우드 플랫폼 모범 사례 가이드

로컬 스킬 (63개)

수작업으로 제작되었으며 대부분 중국어로 14개 카테고리로 그룹화됩니다:

카테고리	예시 스킬	설명
콘텐츠 제작	content-creation-publisher	기사 작성부터 게시까지의 엔드투엔드
비디오 제작	video-creation-suite	전체 비디오 제작 파이프라인
전자상거래	ecommerce-full-pipeline	1688 데이터 스크래핑 → 상품 리스팅 → 마케팅 비디오 → 주문 처리 자동화
문서 처리(내장)	pdf, docx, xlsx, pptx	각 파일 유형 구문 분석, 편집, 생성
AI 어시스턴트 도구	agent-team, multi-agent-meeting	다중 에이전트를 위한 조정 프리미티브
…	…	…

각 스킬은 README에서 별(⭐)로 평가되어 커뮤니티 인기 또는 관리자 신뢰도를 나타냅니다.

---

🛠️ 포함된 도구

• 스킬 검증기 (tools/skill_validator.py) – SKILL.md 파일이 사양을 따르는지 확인하고, LLM 호출용 XML 프롬프트로 스킬을 출력하며, 속성을 JSON으로 읽을 수 있습니다.
• 템플릿 (skills/_template/) – 기여자가 새 스킬을 추가할 수 있는 시작 골격.
• 내보내기 스크립트 – 분석용 JSON ↔ CSV 변환.

---

📊 데이터 형식 스냅샷

{
  "skills": [
    {
      "name": "Anthropic/docx",
      "description": "Word 문서 처리",
      "link": "https://github.com/Anthropic/docx",
      "category": "Document",
      "source": "awesome-agent-skills",
      "crawled_at": "2026-02-02T17:07:33"
    }
  ],
  "total": 182,
  "updated_at": "2026-02-02T17:07:33"
}

로컬 스킬은 유사한 스키마를 따르지만 core_skills, sub_skills, API 요구 사항 분석과 같은 추가 메타데이터를 포함합니다.

---

🚀 누가 사용할까요?

• AI 에이전트 개발자 – 일반 작업에 대한 기성 프롬프트와 래퍼 라이브러리가 필요한 분.
• 제품 팀 – 내부 어시스턴트(예: 영업 어시스턴트 또는 문서 검토 봇)를 구축하고 기존 스킬을 플러그인하려는 팀.
• 연구자 – LLM 에이전트 기능 생태계를 연구하는 분. JSON 덤프는 깔끔한 데이터셋을 제공합니다.
• 교육자와 취미 개발자 – LLM 기반 스킬 구조화 방법의 구체적인 예를 찾는 분.

---

🤝 기여하기

1. 저장소를 포크하세요.
2. 제공된 템플릿을 사용하여 skills/ 아래에 새 스킬을 추가하세요.
3. 검증기를 실행하세요 (python tools/skill_validator.py validate <skill>).
4. PR을 열면 관리자가 검토하고 병합합니다.

README에 링크된 이슈 템플릿을 통해 스킬을 제출할 수도 있습니다.

---

📌 핵심 요약

Skill Store는 모델이나 훈련 프레임워크가 아니라, 모든 LLM 오케스트레이션 시스템에 가져올 수 있는 재사용 가능하고 선언적인 AI 에이전트 기능의 카탈로그입니다. 그 가치는 대규모 공개 스킬 세트의 자동 동기화와 검증 도구 및 내보내기 옵션과 함께 제공되는 중국어 스킬 컬렉션 추가에 있습니다.