클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
← 목록으로

API 테스터

OpenAPI 명세와 실제 라우터 코드를 근거로 추측 없는 API 테스트를 생성하고, 승인된 환경에서만 안전하게 실행하도록 돕는 스킬.

개발·코딩중급★ 868⑂ 95AI 점수 8/10마지막 업데이트: 2026. 9. 22.

무엇을 해주나

  • OpenAPI/Swagger 문서, 라우트·컨트롤러·DTO·검증기, 기존 테스트를 먼저 읽어 실제 계약(contract) 을 파악합니다.
  • 엔드포인트별로 method/path, 인증·권한, 요청 제약, 선언된 응답, 부수효과·멱등성, 정리(cleanup) 방법을 정리한 계약 매트릭스를 만듭니다.
  • 명세와 구현, 기존 테스트 사이의 불일치를 찾아내고, 어느 쪽이 옳은지 불명확하면 추측으로 테스트를 굳히지 않고 확인을 요청합니다.
  • 400/401/404 같은 상태 코드를 관습적으로 가정하지 않고, 계약에 선언되었거나 코드 경로로 실제 도달 가능한 경우에만 단언문을 만듭니다.
  • '테스트 생성'과 '실제 요청 실행'을 분리해, 프로덕션·공유 스테이징·결제/알림 같은 부수효과 작업은 명시적 승인 없이는 수행하지 않습니다.
  • 프로젝트에 이미 있는 테스트 스크립트와 락파일 기반 도구만 사용하고, 임시 npx나 전역 도구 설치를 피합니다.

이런 분께 추천

  • 백엔드 API를 개발하며 통합·회귀 테스트를 보강해야 하는 개발자
  • OpenAPI 명세와 실제 구현이 어긋나는지 점검하려는 QA·플랫폼 엔지니어
  • AI가 만든 테스트가 존재하지 않는 응답 구조를 단언하는 문제로 고생한 팀

활용 예시

  1. "/orders 엔드포인트 통합 테스트를 채워줘" → 라우트와 DTO를 읽고 계약 매트릭스를 만든 뒤, 실제 존재하는 검증 규칙만 대상으로 성공·경계·권한 케이스를 생성합니다.
  2. "OpenAPI 명세와 실제 응답이 같은지 확인해줘" → 명세와 핸들러 구현을 대조해 불일치 목록을 보고하고, 어떤 쪽이 기대 동작인지 확인을 요청합니다.
  3. "스테이징에서 이 테스트 돌려줘" → Base URL, 테스트 계정, 쓰기 요청 허용 여부, 데이터 정리 방안을 먼저 확인하고 승인 후에만 최소 범위로 실행하며, 실행 명령·종료 코드·잔여 데이터 여부를 보고합니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/laolaoshiren/claude-code-skills-zh/HEAD/skills/api-tester/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 laolaoshiren/claude-code-skills-zh 의 skills/api-tester 폴더를 내 ~/.claude/skills/api-tester/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/laolaoshiren/claude-code-skills-zh.git /tmp/ccs-zh && mkdir -p ~/.claude/skills && cp -r /tmp/ccs-zh/skills/api-tester ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/laolaoshiren/claude-code-skills-zh.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r claude-code-skills-zh/skills/api-tester ~/.claude/skills/
  5. ~/.claude/skills/api-tester/SKILL.md 파일이 있는지 확인합니다.
  6. Claude Code를 다시 실행한 뒤 "이 프로젝트의 API 통합 테스트를 만들어줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
  7. 실제 요청 실행이 필요하면 대상 환경(local/test/staging)과 쓰기 작업 허용 여부를 먼저 명확히 알려주세요.