본문으로 건너뛰기
cccskills
무료GitHub에 공개한국어 소개

api-design-principles

REST와 GraphQL 설계 원칙에 따라 API 사양을 계획하거나 검토합니다. 리소스와 스키마 설계, 페이지네이션, 버전 관리, 오류 처리를 정리하고 예시, 체크리스트, 템플릿, OpenAPI 생성 스크립트를 참고할 수 있습니다.

원문원문 설명 보기

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

LeoYeAI/agent-master-skills스타 2,193(GitHub 2,193 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

  • 새 API 사양 계획
  • 구현 전 API 사양 검토
  • 팀의 API 설계 규칙 정리
  • REST와 GraphQL 전환 검토

한국어 소개

할 수 있는 일

REST와 GraphQL API를 설계하거나 사양을 검토할 때 설계 원칙을 적용할 수 있습니다. REST에서는 리소스를 표현하는 방식과 HTTP 메서드의 용도를 검토하고, GraphQL에서는 스키마와 쿼리 구조를 정리합니다. 페이지네이션, 필터링, 오류 응답, 버전 관리와 흔히 생기는 설계 문제도 다룹니다. GraphQL의 타입, 뮤테이션, 리졸버 예시와 함께 연관 데이터를 효율적으로 가져오기 위한 DataLoader 개념도 설명합니다. API 검토와 팀의 설계 기준 마련에 쓸 체크리스트와 템플릿, OpenAPI 사양 생성 스크립트도 자료에 포함되어 있습니다.

이럴 때 유용합니다

구현 전에 새 API 사양을 확정하거나 기존 API의 사용성을 다시 살펴볼 때 유용합니다. REST와 GraphQL 중 무엇을 선택할지, 한 방식에서 다른 방식으로 옮길지 검토하거나 팀의 설계 규칙을 맞출 때도 활용할 수 있습니다.

사용 예시

  • “이 REST API의 엔드포인트 설계를 검토해 주세요.”
  • “사용자와 주문을 다루는 GraphQL 스키마 초안을 만들어 주세요.”
  • “API 버전 관리 방식을 비교해 주세요.”

주의 사항

특記事項はありません。

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

문서 점검

AI가 SKILL.md의 내용에서 주의가 필요한 작업과 도입 전제를 확인했습니다. 점수는 실제로 실행한 결과(실행 검증)만으로 매깁니다.

안전성전송·삭제·명령 실행 등을 명시하고 있는가
A양호DELETE 설계 예시는 있지만 외부 작업을 실행하라는 지시는 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가
A양호API 키나 외부 서비스가 필요하다는 전제는 기재되어 있지 않습니다.

점수에는 넣지 않았습니다. 2026년 11월 15일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

어느 항목이 왜 다르다고 생각하는지 적어 주세요. 로그인은 필요 없습니다. SKILL.md와 대조해 평가를 다시 만들고 이곳에 반영합니다.

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

포함된 파일(5)

  • SKILL.md13.4 KB
  • assets/api-design-checklist.md3.8 KB
  • assets/rest-api-template.py5.2 KB
  • references/graphql-schema-design.md8.8 KB
  • references/rest-best-practices.md7.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

0codekit

무료요약 있음

Membrane CLI를 통해 0codekit 워크스페이스 데이터에 연결합니다. 표와 데이터베이스, 작업, 일정, 이메일, 채팅 메시지, 문서 등을 다루며, 요청이 모호하면 앱이나 데이터에 관한 추가 정보가 필요합니다.

  • 0codekit 워크스페이스 정보 다루기
  • 표 또는 데이터베이스 확인
  • 작업과 일정 참조
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

0xarchive

무료요약 있음

0xArchive API로 Hyperliquid, Lighter.xyz, HIP-3의 과거 및 현재 시장 데이터를 조회합니다. 가격, 캔들, 주문장, 거래, 펀딩 비율, 미결제약정, 청산과 데이터 최신성 및 범위를 확인할 수 있습니다.

  • 지원 거래소의 과거 가격 조회
  • 주문장과 거래 기록 확인
  • 펀딩 비율과 미결제약정 추적
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

12-factor-apps

무료요약 있음

코드베이스를 12-Factor App의 12개 원칙에 따라 점검하고 설정, 의존성, 로그 등의 준수 수준과 근거를 정리합니다. 파일과 줄 번호를 제시하고 우선순위별 개선안도 제공합니다.

  • SaaS 애플리케이션 구조 감사
  • 클라우드 이전 전 문제 파악
  • 컨테이너화 전 구성 점검
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

13-Day Sprint Method

무료요약 있음

마야력에서 영감을 얻은 13일 주기로 개인 또는 팀 프로젝트의 목표 설정, 실행, 결과 공유와 회고를 진행합니다. 매일의 13가지 ‘톤’이 그날의 초점을 안내합니다.

  • 13일 동안 개인 프로젝트 진행
  • 팀 스프린트의 일일 초점 정하기
  • 오늘의 행동 방향 확인
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

13c-metabolic-flux

무료요약 있음

정상 상태의 탄소 13 추적 측정값으로 세포 내 대사 플럭스를 추정합니다. 탄소 원자 매핑과 측정 입력을 점검하고 표지 분포를 모의한 뒤, 데이터가 제약할 수 있는 경로 반응 속도를 평가합니다.

  • 탄소 13 측정값으로 대사 플럭스 추정
  • 원자 매핑과 측정 입력의 일관성 확인
  • 지정한 플럭스로 표지 분포 예측
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

1688 Sourcing Agent

무료요약 있음

1688.com을 통한 상품 소싱을 단계별로 안내합니다. 상품 선정, 공급업체 확인, 샘플 요청, 가격 협상, 운송 방식 비교를 돕고, 상품 정보와 결제에 따른 위험 및 소싱 전문가에게 문의할 시점도 정리합니다.

  • 1688.com 공급업체 확인하기
  • 예산에 맞는 상품 후보 좁히기
  • 가격 협상이나 샘플 요청하기
LeoYeAI/agent-master-skills2.2천2026년 11월 1일 업데이트

LeoYeAI의 스킬 모두 보기

이 스킬의 문제 신고