<div align="center">
Awesome API Skills — Visual Overview
멋진 API 스킬 모음 (Awesome API Skills)
프로덕션 환경에서 사용 가능하며 스키마가 검증된 SKILL.md 컨텍스트 명세로, AI 코딩 에이전트가 환각(hallucinating) 없이 실제 API를 다루는 방법을 학습하게 합니다.
<p>
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT 라이선스"></a>
<img src="https://img.shields.io/badge/skills-125%20verified-38bdf8?style=flat-square" alt="125개 검증된 스킬">
<img src="https://img.shields.io/badge/graph-273%20edges-818cf8?style=flat-square" alt="273개의 그래프 간선">
<img src="https://img.shields.io/badge/runtime-React%20%2B%20Vite-10b981?style=flat-square" alt="React + Vite">
</p>
<p>
<a href="./index.html"><strong style="font-size: 1em;">🔍 대화형 웹 애플리케이션</strong></a> ·
<a href="./docs/BENCHMARKS_AND_EXAMPLES.md"><strong style="font-size: 1em;">📊 벤치마크 및 차이점 (Benchmarks & Diffs)</strong></a> ·
<a href="./docs/CLI_USAGE.md"><strong style="font-size: 1em;">💻 CLI 사용법 참고 자료 (CLI Reference)</strong></a> ·
<a href="#quick-start"><strong style="font-size: 1em;">🚀 빠른 시작 (Quick Start)</strong></a> ·
<a href="#contributing"><strong style="font-size: 1em;">🤝 기여하기 (Contributing)</strong></a>
</p>
</div >
💡 문제점과 해결책 (The Problem & The Solution)
AI 코딩 에이전트(Claude Code, Cursor, Cline, Continue, Windsurf, 또는 OpenAI Codex)가 최신 API에 대한 코드를 생성할 때, 오래된 훈련 데이터로 인해 심각한 결함을 자주 발생시킵니다:
- ❌ 손상된 웹훅 검증(Broken Webhook Verification): 암호화 서명(예: Stripe, Svix, Paddle, Polar)을 확인하기 전에
express.json()으로 원시 요청 본문(raw request bodies)을 파싱하여 SignatureVerificationError를 유발함.
- ❌ 사용 중단된 SDK 메서드(Deprecated SDK Methods): 레거시 SDK 생성자나 미들웨어(예: v5의
clerkMiddleware 대신 Clerk v4의 authMiddleware, 최신 Vercel AI SDK v4의 streamText 대신 구식 Vercel AI SDK v2의 OpenAIStream)를 생성함.
- ❌ 배치 처리되지 않은 HTTP 루프(Unbatched HTTP Loops): 트랜잭션 API(Resend, SendGrid, Twilio)에 대해 배치 처리가 되지 않은 루프를 실행하여
HTTP 429 Too Many Requests 응답을 받음.
- ❌ 연결 풀링 누락(Missing Connection Pooling): 서버리스 함수(Neon, Supabase, PostgreSQL) 내부에서 연결 풀링되지 않은 데이터베이스 연결을 생성하여 연결 제한을 초과함.
awesome-api-skills는 125개의 큐레이션되고 스키마가 검증된 'SKILL.md' 컨텍스트 파일을 제공하여 이러한 문제를 해결합니다. 워크스페이스(.claude/skills/, .cursor/skills/, .agents/skills/)에 스킬을 추가하면, 코드가 단 한 줄 생성되기 전에 결정론적 매개변수(deterministic parameters), 환각 방지 체크리스트(anti-hallucination checklists), 그리고 검증된 코드 패턴을 제공합니다.
⚡ 실제 영향: 이전 vs. 이후 (Before vs. After)
| 통합 도메인 | ❌ 스킬 없이 (LLM 추측) | ✅ SKILL.md 사용 시 (컨텍스트 주입) |
|---|
| Stripe 웹훅 | express.json()으로 JSON을 파싱하여 원시 페이로드 버퍼를 손상시키고 서명 검증에 실패함. | stripe.webhooks.constructEvent()가 인증된 HMAC 서명을 검증할 수 있도록 express.raw({ type: 'application/json' })를 주입함. |
| ... | | |
📖 docs/BENCHMARKS_AND_EXAMPLES.md에서 실행 가능한 전체 diff를 검토하세요.
🚀 빠른 시작 (Quick Start)
1. 프로젝트에 직접 복사 (의존성 없음)
원하는 스킬 디렉터리를 AI 코딩 에이전트의 설정에 직접 복사합니다:
git clone --depth 1 https://github.com/Ghost7802/awesome-api-skills.git
...
어시스턴트에게 다음과 같이 프롬프트를 요청하세요:
".claude/skills/stripe/SKILL.md와 .claude/skills/inngest/SKILL.md를 사용하여 구독 웹훅(subscription webhooks)을 구현해 주세요."
2. CLI 및 워크스페이스 검증기 사용하기
저장소의 CLI를 사용하여 스킬을 검색, 검증 및 검사할 수 있습니다:
node packages/cli/dist/bin.js search "embeddings vector rag"
...
📚 스킬 카탈로그 (125개 검증된 스킬)
저희 카탈로그는 15개의 핵심 기술 도메인에 걸쳐 125개의 검증된 스킬을 다루고 있습니다:
| 카테고리 | 포함된 스킬 |
|---|
| AI, LLM 및 추론 (Reasoning) | deepseek, openai, anthropic, gemini, groq, mistral, cohere, elevenlabs, replicate, ollama, vllm, langchain, llamaindex, vercel-ai-sdk, langgraph, anthropic-mcp, azure-openai |
| ... | |
🌐 npm run dev 또는 배포된 Vercel 앱을 통해 검색 가능한 인터랙티브 애플리케이션을 찾아보세요.
🏗️ 모노레포 아키텍처 (Monorepo Architecture)
awesome-api-skills는 고성능 TypeScript 워크스페이스로 구성되어 있습니다:
├── skills/ # 125개 SKILL.md 사양, metadata.json 계약 및 실행 가능한 예제
├── src/ # 인터랙티브 React + Vite + Tailwind CSS 애플리케이션
├── api/ # Vercel 서버리스 함수 (/api/skills, /api/search, /api/validate)
...
🎯 검증 및 품질 보증 (Verification & Quality Assurance)
이 저장소의 모든 스킬은 자동화된 검증 파이프라인에 의해 엄격하게 관리됩니다:
- 결정론적 스키마 강제 적용 (Deterministic Schema Enforcement): 100%의 스킬(125/125)이
packages/validator를 통해 SKILL.md v1.0 스키마 사양을 검증합니다.
- 자동화된 단위 및 카탈로그 테스트 (Automated Unit & Catalog Tests): Vitest를 사용하여 13개의 테스트 스위트 전반에 걸쳐 169개의 종합적인 테스트가 CI에서 실행됩니다.
- 검증된 지식 그래프 (Verified Knowledge Graph): 273개의 검증된 관계 에지(relationship edges)는 필수 조건, 대안 및 풀스택 통합 레시피를 매핑합니다.
- 측정된 성능 (Measured Performance): 실시간
performance.now() 원격 측정(telemetry)은 워크스페이스 파싱(~43.6ms)과 역색인 검색(<1ms)을 측정합니다.
🤝 기여하기
새로운 API 스킬이나 기존 문서의 개선 사항에 대한 기여를 환영합니다!
- 저장소 포크 및 클론하기:
git clone https://github.com/Ghost7802/awesome-api-skills.git
cd awesome-api-skills
npm install
...
2. `skills/<스킬 이름>/` 아래에 `SKILL.md`와 `metadata.json`을 포함하는 스킬을 생성합니다.
3. **스키마 유효성 검사 및 테스트 스위트 실행**:
```bash
npm run validate:skills
npm test
- Pull Request를 제출합니다. 자동화된 GitHub Actions 워크플로우가 제출 내용을 검토하고 유효성을 검사할 것입니다.
전체 스타일 가이드라인 및 채점 규칙은 CONTRIBUTING.md를 참조하세요.
📄 라이선스
MIT 라이선스에 따라 배포됩니다. © 2026 Awesome API Skills Team.