ComposioHQ/awesome-claude-skills · 언어 Python(검증 CI) + Markdown(문서) + SKILL.md(스킬 규격) · 담긴 스킬 864개 SKILL.md(Composio 앱 자동화 832 + 큐레이션 32) · README 외부 링크 184개 · ★ 70.0k · fork 7.9k · 이슈/PR 1,093개 · 생성 2025-10-17 · 최근 갱신 2026-07-24 · 라이선스 Apache-2.0 · shallow clone 소스 직접 분석)
2025년 10월, Anthropic이 Claude Skills라는 새 규격을 발표했다. 한마디로 "AI에게 특정 작업을 어떻게 처리하는지 적어 둔 재사용 가능한 설명서 폴더"다. 규격이 열리자마자 전 세계 개발자들이 자기만의 스킬을 쏟아내기 시작했는데, 문제는 그것들이 수백 개 저장소에 흩어져 있다는 것. "좋은 스킬이 어디 있지?", "스킬은 대체 어떻게 만들지?", "만든 걸 내 Gmail·Slack에 어떻게 연결하지?" — 이 세 질문에 한 번에 답하려고 만든 저장소가 바로 이것이다.
보통 어썸 리스트는 "관광 지도"다 — 어디에 뭐가 있는지 링크만 알려주고 끝난다. 그런데 이 저장소는 지도를 주면서 인기 맛집 몇 곳은 아예 도시락으로 싸서 손에 쥐여 준다(폴더 안에 실제 스킬 864개 동봉). 게다가 "현지 교통편"까지 붙여 준다 — Composio라는 회사의 커넥터 게이트웨이로 Gmail·Slack·GitHub 등 1,000개 앱에 스킬을 곧바로 연결시켜 준다.
그래서 이 저장소는 "읽는 문서"이자 "쓰는 도구상자"다. 초보자 입장에서 구성은 이렇게 나뉜다. ① What Are Claude Skills? — 스킬의 정의와 작동 원리 설명 → ② Skills 목록 — 13개 분류로 정돈된 184개 외부 스킬 링크 → ③ 번들 스킬 — 저장소가 직접 담은 32개 큐레이션 스킬 + 832개 앱 자동화 스킬 → ④ connect-apps 플러그인 — 스킬을 실제 앱에 연결하는 실행 계층. 지도만 보고 끝낼 수도, 도시락을 뜯어 바로 먹을 수도 있다.
SKILL.md(이름·설명이 담긴 YAML 머리말 + 마크다운 지침)를 두고, 필요하면 스크립트·참고자료·템플릿을 함께 넣는다. Anthropic이 2025년 10월 도입해 12월 오픈 표준으로 공개했고, 지금은 Claude Code·Claude.ai·API는 물론 Codex·Cursor·Gemini CLI·Antigravity·Windsurf까지 지원한다.이 저장소가 9개월 만에 ★70,021을 모은 건 단순히 링크를 잘 모아서가 아니다. 타이밍과 포지셔닝 둘 다를 잡았다. Skills 규격은 2025년 10월에 막 나온 신생 표준(emerging standard)이고, 신생 표준에는 항상 "그래서 뭐가 좋은데?"를 정리해 주는 첫 번째 백과사전이 필요하다. 이 저장소가 그 자리를 선점했다.
| 비교 대상 | 이 저장소의 차별점 |
|---|---|
| anthropics/skills (공식 예제) | 공식은 정석 예제 소수. 이곳은 외부 커뮤니티 스킬 184개를 13개 분류로 폭넓게 큐레이션 + 실물 864개 동봉 |
| 보통의 awesome-* 리스트 | 대부분 링크만 나열. 이곳은 SKILL.md를 저장소에 직접 담아 clone 즉시 사용 가능 |
| 개별 스킬 저장소 | 하나씩 찾아다녀야 함. 이곳은 한 저장소 = 한 번의 clone으로 수백 개를 한꺼번에 |
| MCP 서버 마켓 | 연결(auth·전송)만 제공. 이곳은 스킬(행동 지침) + 커넥터(실행)를 함께 묶어 "무엇을 어떻게"까지 커버 |
최근 갱신일이 2026-07-24(딥다이브 작성 전날)라는 점도 눈에 띈다. 이슈·PR이 1,093건 열려 있는 건 그만큼 사람들이 계속 새 스킬을 밀어 넣고 있다는 신호다. 살아 있는 저장소이고, 그래서 TrendShift에 다시 트렌딩으로 올라왔다.
저장소가 담은 864개 SKILL.md 중 832개는 composio-skills/ 아래 앱 자동화 스킬인데, 열어 보면 전부 거의 똑같은 템플릿이다 — "Rube MCP로 도구를 검색 → 연결 → 실행"이라는 동일 패턴을, 앱 이름만 바꿔 832번 복제했다. 즉 "1,000개 스킬"은 독립적으로 정성껏 만든 1,000개가 아니라, 큐레이션 184 + 손수 만든 32 + 자동 양산 832의 합이다.
또 이 저장소는 Composio라는 회사의 마케팅 자산이기도 하다. 곳곳에 dashboard.composio.dev 가입·Rube MCP 유도가 박혀 있다. 자료로서의 가치는 분명하지만, "중립적 커뮤니티 큐레이션"이라기보다 "공급사가 운영하는 카탈로그"라는 점을 알고 보면 균형이 잡힌다.
awesome-claude-skills에는 서버도, 프론트엔드 화면도 없다. 대신 4개의 계층이 겹쳐 있다: 사람이 읽는 콘텐츠 계층, AI가 읽는 스킬 계층, 앱에 연결하는 커넥터 계층, 그리고 품질을 지키는 CI 계층. 각 계층이 쓰는 "기술"을 풀면 이렇다.
| 구성 | 역할 |
|---|---|
README.md (503줄) | 스킬 정의 · 13개 분류로 정돈된 184개 스킬 링크 · 시작 가이드 · 만드는 법 · 참고자료. 이 저장소의 얼굴 |
CONTRIBUTING.md | 스킬 등록 기준(실제 사용 사례일 것 · 중복 금지 · 안전할 것) + SKILL.md 템플릿 |
| Markdown / GFM | 앵커 목차 · 배지 · 표. 특별한 정적 사이트 생성기 없이 GitHub 렌더링에만 의존 |
| 구성 | 역할 |
|---|---|
SKILL.md × 864 | 스킬 하나 = 폴더 하나 + SKILL.md 하나. YAML 머리말(name·description·requires) + 마크다운 지침으로 구성 |
| 큐레이션 스킬 32개 | 손수 만든 실물. changelog-generator·brand-guidelines·mcp-builder·skill-creator 등. 일부는 scripts/·templates/ 동봉 |
| Composio 앱 스킬 832개 | composio-skills/ 아래. 전부 같은 Rube MCP 패턴의 자동 생성물(ably·airtable·zoom …) |
| YAML frontmatter | 세션 시작 시 AI가 읽는 "이름표"(약 100토큰). 여기에 requires: {mcp: [rube]}로 의존성 선언 |
| 구성 | 역할 |
|---|---|
connect-apps-plugin/ | Claude Code 플러그인. .claude-plugin/plugin.json + /connect-apps:setup 슬래시 명령 |
| Composio MCP Gateway | https://connect.composio.dev/mcp 엔드포인트 하나로 1,000+ 앱에 인증·연결(auth·team 접근제어·감사로그) |
| Rube MCP | https://rube.app/mcp. RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL 3-스텝 실행 런타임 |
| 구성 | 역할 |
|---|---|
.github/workflows/label-ready-skill.yml | PR이 열리면 base/head README를 받아 diff를 검사해 "병합 준비됨" 라벨을 자동 부여 |
| Python (언어 표기) | GitHub이 이 저장소를 Python으로 분류 — 검증·생성 스크립트가 파이썬이라는 뜻(832개 양산의 흔적) |
pull_request_target | 포크에서 온 PR도 안전하게 라벨링하도록 설계된 트리거. 대량 기여를 받는 저장소의 전형 |
콘텐츠는 "가게 간판과 메뉴판"(사람이 봄), 스킬은 "주방의 레시피 카드"(요리사=AI가 봄), 커넥터는 "식재료 납품 계약"(외부 앱에서 재료를 가져옴), CI는 "새 레시피가 들어올 때 위생 검사하는 직원"이다. 네 계층이 맞물려 "읽고 → 쓰고 → 연결하고 → 검수하는" 순환이 돈다.
스킬 수백 개를 한 에이전트에 넣으면 컨텍스트가 터지지 않을까? 안 터진다. 그 비결이 점진적 로딩(progressive disclosure)이다. 세션이 시작될 때 AI는 각 스킬의 이름과 설명만 본다 — 스킬당 약 100토큰. 그 작업에 스킬이 필요하다고 판단하면 그제서야 SKILL.md 본문(보통 5,000토큰 미만)을 불러오고, scripts/·references/는 더 필요할 때만 읽는다.
도서관에 책이 수백 권 있어도 머리가 안 터지는 이유는, 평소엔 책등의 제목만 훑기 때문이다(=이름+설명 100토큰). 필요한 책만 꺼내 펼치고(=SKILL.md 본문), 그 안의 부록은 참조가 걸릴 때만 넘긴다(=scripts/). 스킬 시스템은 이 "도서관 열람" 방식을 그대로 구현한 것이다.
초보자가 가장 헷갈리는 지점이다. README가 명확히 선을 긋는다: MCP는 "연결"(auth·전송·도구 발견), 도구(tool)는 "개별 동작"(에이전트가 호출하는 함수 하나), 스킬은 "행동 방식"(무엇을·어떤 순서로·어떤 안전장치로). 셋은 경쟁이 아니라 한 몸으로 함께 돈다.
| 계층 | 담당 | 비유 |
|---|---|---|
| MCP | 외부 시스템에 연결 (인증·전송·도구 목록 제공) | 콘센트·전선 (전기가 들어오는 통로) |
| 도구(tool) | 에이전트가 부르는 개별 함수 (메일 보내기 등) | 가전제품 (실제 일하는 기계) |
| 스킬(skill) | 연결·도구가 갖춰진 뒤 워크플로를 정의 | 요리 레시피 (순서·주의사항) |
832개 Composio 앱 스킬이 전부 공유하는 뼈대다. 핵심 철학은 "도구 슬러그를 절대 하드코딩하지 마라" — 스키마는 언제든 바뀌므로 항상 먼저 검색한 뒤 실행하라는 것. 방어적 설계의 좋은 사례다.
SKILL.md가 "코드"가 아니라 AI에게 주는 절차 지시서라는 점이 여기서 드러난다. 스킬은 실행 엔진이 없다 — AI가 이 마크다운을 읽고 그대로 따라 하는 것이 곧 실행이다. 그래서 "항상 SEARCH 먼저", "memory는 빈 객체라도 넣어라" 같은 주의(Known Pitfalls)가 본문에 자연어로 적혀 있다.
구조를 관통하는 규칙은 하나다: "스킬 = 폴더 + SKILL.md". 큐레이션 스킬이든 자동 양산 스킬이든, 심지어 문서 묶음(document-skills/)이든 — 모두 이 최소 단위를 따른다. 그래서 어떤 폴더든 SKILL.md만 열면 그게 무슨 스킬인지 즉시 파악된다. 초보자가 저장소를 탐험하는 가장 빠른 길은 "관심 있는 폴더의 SKILL.md 머리말(name·description) 3줄만 읽어 보는 것"이다.
① README.md의 "What Are Claude Skills?" 절 → ② CONTRIBUTING.md의 SKILL.md 템플릿 → ③ changelog-generator/SKILL.md(잘 쓰인 실물 하나) → ④ composio-skills/ably-automation/SKILL.md(양산 패턴 하나) → ⑤ connect-apps-plugin/commands/setup.md(연결이 실제로 어떻게 되는지). 이 다섯 파일이 저장소의 축소판이다.
스킬의 성패는 description 한 줄에 달렸다. AI는 세션 시작 시 이 설명만 보고 "언제 이 스킬을 쓸지"를 판단하기 때문이다. changelog-generator의 설명이 좋은 본보기다: "무엇을 하는지 + 언제 쓰는지 + 어떤 이득인지"를 한 문장에 눌러 담았다. CONTRIBUTING의 조언도 핵심을 찌른다 — "사용자가 아니라 Claude를 향해 쓰라(Write instructions for Claude, not end users)".
---
name: changelog-generator
description: git 커밋에서 사용자용 변경로그를 자동 생성 — 기술적 커밋을
고객 친화적 릴리스 노트로 변환. 언제: 릴리스 노트·주간 업데이트 작성 시.
---
# Changelog Generator
## When to Use This Skill ← AI의 "발동 조건" 힌트
## What This Skill Does ← 단계별 동작 명세
## How to Use ← 구체 절차"많은 능력을 넣으면 프롬프트가 무거워진다"는 딜레마를 지연 로딩(lazy loading)으로 푸는 발상은 스킬 밖에서도 통한다. RAG, 툴 라우팅, 에이전트 설계 어디서든 "이름표는 항상, 본문은 필요할 때"라는 원칙은 재사용된다. 이 저장소는 그 원칙을 864개 규모로 실증하는 살아 있는 사례다.
AI 에이전트를 처음 설계할 때 "이걸 스킬로 만들까, MCP로 만들까, 도구로 만들까?"에서 막힌다. 이 저장소의 답은 명확하다: 연결이 필요하면 MCP, 개별 동작이면 도구, 절차·판단·안전장치면 스킬. 이 3분법만 잡아도 에이전트 아키텍처가 정리된다.
이슈·PR 1,093건을 처리하는 저장소는 자동화 없이 못 버틴다. label-ready-skill.yml이 PR의 README diff를 검사해 라벨을 자동으로 붙이는 방식은, "사람 리뷰어의 눈"을 CI로 일부 대체하는 실전 패턴이다. pull_request_target 트리거로 포크 PR까지 안전하게 다루는 것도 배울 점.
832개 Composio 스킬은 편리하지만 자동 생성물이다. 실제 도구 슬러그·스키마는 스킬이 스스로 경고하듯 "언제든 바뀐다". 그래서 스킬 본문도 "하드코딩 말고 항상 RUBE_SEARCH_TOOLS 먼저"라고 못 박는다. 편의성만 보고 검증 없이 실 서비스에 붙이면, 스키마가 바뀐 순간 조용히 깨진다. 스킬은 출발점이지 완성품이 아니다.
| 항목 | 요구사항 |
|---|---|
| 실행 주체 | Claude Code / Claude.ai / Claude API 중 하나. Codex·Cursor·Gemini CLI·Antigravity·Windsurf도 스킬 지원 |
| 저장소 사용 | git clone만 하면 끝. 빌드·컴파일 불필요 (문서+마크다운 저장소) |
| 스킬 설치 (Claude Code) | 스킬 폴더를 ~/.config/claude-code/skills/에 복사 → claude 실행 시 자동 로드 |
| 스킬 설치 (Claude.ai) | 채팅의 🧩 아이콘 → 마켓플레이스에서 추가 또는 커스텀 업로드 |
| 커넥터 (선택) | connect-apps 사용 시 Composio API 키(무료). claude --plugin-dir ./connect-apps-plugin → /connect-apps:setup |
| Rube MCP (선택) | 앱 자동화 스킬용. https://rube.app/mcp를 MCP 서버로 추가 — API 키 없이 엔드포인트만 |
| 비용 | 저장소·스킬 자체 무료(Apache-2.0). Claude 사용료·Composio 유료 플랜은 별도 |
요구사항의 핵심은 "인프라가 아니라 계정"이라는 점이다. 서버를 세울 필요도, GPU도 없다. 대신 Claude를 쓸 환경 하나 + (원하면) Composio 계정이면 864개 스킬이 즉시 손에 들어온다. 진입 장벽이 낮은 게 70k 스타의 또 다른 이유다. 다만 커넥터가 실제 앱에 쓰기 동작(메일 발송·이슈 생성)을 하므로, 권한과 팀 접근제어는 신중히 설정해야 한다.
changelog-generator·brand-guidelines·ably-automation 세 SKILL.md의 description과 "When to Use"만 뽑아 한 표로 정리한다. "잘 쓰인 설명 vs 자동 생성된 설명"이 어떻게 다른지, AI가 무엇을 보고 스킬을 고르는지가 눈에 들어온다. 코드 한 줄 없이 스킬의 본질을 체감하는 워밍업.
CONTRIBUTING의 템플릿을 복사해 아주 작은 스킬(예: "회의록을 3줄 요약으로")을 하나 쓴다. ~/.config/claude-code/skills/에 넣고 claude를 실행한 뒤, 관련 요청을 던져 스킬이 자동 발동되는지 확인한다. description을 일부러 모호하게/명확하게 바꿔 가며 발동률이 어떻게 달라지는지 관찰.
composio-skills/에서 서로 다른 앱 스킬 5개를 골라 diff를 떠 본다. Prerequisites·Setup·3-스텝 패턴·Known Pitfalls·Quick Reference가 어디까지 똑같고 무엇만 앱 이름으로 치환됐는지 찾아, "이 832개를 생성한 템플릿"을 종이에 복원한다. 자동 생성 콘텐츠의 구조를 읽는 눈이 생긴다.
connect-apps-plugin을 --plugin-dir로 로드하고 /connect-apps:setup으로 Composio 키를 넣어 ~/.mcp.json이 어떻게 쓰이는지 관찰한다. 그런 다음 "테스트 메일 보내줘"를 시켜 스킬→MCP→도구가 한 몸으로 도는 흐름을 로그로 추적한다. 쓰기 권한이 실제로 어떻게 요청되는지 눈으로 확인.
skill-creator를 참고해, 입력 명세를 받아 규격에 맞는 SKILL.md를 자동 생성하는 메타 스킬(또는 파이썬 스크립트)을 짠다. 이 저장소가 832개를 양산한 방식을 내 도메인(사내 API 등)에 재현하는 것이다. 여기에 label-ready-skill.yml 스타일의 간단한 검증 CI까지 붙이면, "스킬 공급소"의 축소판을 스스로 운영하게 된다.
| 주차 | 주제 | 학습 내용 |
|---|---|---|
| 1주차 | 스킬 규격 기본 | SKILL.md 구조(YAML frontmatter · name · description) / 좋은 description 쓰기 / When-to-Use 힌트 / 점진적 로딩. 대응: README.md · CONTRIBUTING.md · changelog-generator/ |
| 2주차 | MCP와 도구 연결 | MCP 프로토콜(auth·전송·도구 발견) / plugin.json·슬래시 명령 / ~/.mcp.json 구성 / Rube 3-스텝 패턴. 대응: connect-apps-plugin/ · composio-skills/ · anthropics/skills |
| 3주차 | 스킬·MCP·도구 3층 설계 | "연결/동작/절차" 3분법 / 언제 무엇으로 만들지 / 안전장치(파괴적 동작 확인)를 스킬에 담는 법 / 크로스 플랫폼 이식성. 대응: mcp-builder/ · skill-creator/ |
| 4주차 | 대규모 스킬 운영·양산 | 템플릿 기반 스킬 생성 / 품질 검증 CI(pull_request_target · diff 라벨링) / 스킬 마켓·배포 / 버전·스키마 변화 대응. 대응: .github/workflows/ · Skills API 문서 |
이 순서를 밟으면 awesome-claude-skills는 단순한 "링크 모음"이 아니라 에이전트에게 능력을 부여하는 전 과정을 실물로 보여 주는 교재가 된다. 1주차의 "설명서 쓰기"에서 시작해 4주차의 "설명서 공장 운영"까지, 각 단계가 정확히 저장소의 어느 폴더·파일에 대응되므로 이론과 실제를 왕복하며 익힐 수 있다.
| 용어 | 의미 |
|---|---|
| Claude 스킬 (Skill) | 특정 작업 처리법을 담은 재사용 지침 폴더. 핵심은 SKILL.md 하나 |
| SKILL.md | 스킬의 본체. YAML 머리말(name·description) + 마크다운 지침. AI가 읽고 그대로 따라 함 |
| YAML frontmatter | 파일 맨 위 --- 사이의 메타데이터. name·description·requires 등을 선언 |
| 어썸 리스트 (awesome list) | 특정 주제의 좋은 자료를 카테고리별로 모은 큐레이션 목록. GitHub의 오랜 전통 |
| 점진적 로딩 (progressive disclosure) | 이름+설명(≈100토큰)은 항상, 본문·부록은 필요할 때만 로드해 컨텍스트 절약 |
| MCP (Model Context Protocol) | 에이전트가 외부 시스템에 연결하는 표준(인증·전송·도구 발견). "연결" 담당 |
| 도구 (tool) | 에이전트가 호출하는 개별 함수(메일 보내기 등). "개별 동작" 담당 |
| 스킬 vs MCP vs 도구 | 스킬=절차/행동, MCP=연결, 도구=동작. 셋이 한 몸으로 함께 돎 |
| Composio | 1,000+ SaaS 연결을 제공하는 회사. 이 저장소의 운영·후원 주체 |
| MCP Gateway | 단일 MCP 엔드포인트로 수천 앱에 인증·연결·감사로그를 몰아 주는 관문 |
| Rube MCP | Composio의 실행 런타임. SEARCH→CONNECTIONS→EXECUTE 3-스텝으로 도구 실행 |
| RUBE_SEARCH_TOOLS | 실행 전 "지금 유효한 도구 슬러그·스키마"를 검색. 하드코딩 방지의 핵심 |
| 플러그인 (plugin) | Claude Code 확장 묶음. .claude-plugin/plugin.json + 슬래시 명령으로 구성 |
| 슬래시 명령 (slash command) | /connect-apps:setup처럼 /로 부르는 정의된 명령. 여기선 셋업 자동화 |
| pull_request_target | 포크에서 온 PR도 안전하게 다루도록 설계된 GitHub Actions 트리거 |
| progressive standard (신생 표준) | Skills처럼 막 열려 빠르게 채택되는 규격. 첫 백과사전이 선점 효과를 가짐 |
README.md("What Are Claude Skills?" 절 + 13분류 목록) · CONTRIBUTING.md(SKILL.md 템플릿·등록 기준)changelog-generator/(잘 쓰인 실물) · skill-creator/·mcp-builder/(메타 스킬) · composio-skills/(양산 832) · connect-apps-plugin/(실행 계층)