api-first-design
**API FIRST DESIGN**: 'API 만들어', 'API 설계', '엔드포인트', 'REST', 'Swagger', 'OpenAPI', 'DTO', 'CRUD' 요청 시 자동 발동. *.controller.ts/*.dto.ts/routes/** 파일 작업 시 자동 적용. Contract-First, 표준 응답 포맷, 타입 자동 생성.
npx skills add majiayu000/claude-skill-registry --skill api-first-design --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# API First Design Skill > **Version**: 1.0.0 > **Purpose**: Swagger/OpenAPI 기반 Contract-First API 설계 및 일관된 응답 포맷 보장 > **Target**: NestJS + Next.js + Expo Monorepo --- ## Document Loading Strategy **전체 문서를 로드하지 않습니다!** 상황에 따라 필요한 문서만 로드: ```yaml Document_Loading_Strategy: Step_1_Detect_Framework: - 파일 확장자, import 문, 데코레이터로 프레임워크 감지 - 불명확하면 package.json/requirements.txt 확인 Step_2_Load_Required_Docs: Universal_Always_Load: - "core/contract-first.md" # Contract-First 원칙 (항상) - "core/response-format.md" # 표준 응답 포맷 (항상) - "core/error-codes.md" # 에러 코드 체계 (항상) Framework_Specific_Load: NestJS: "frameworks/nestjs-swagger.md" # NestJS Swagger 데코레이터 Express: "frameworks/express-openapi.md" # Express OpenAPI FastAPI: "frameworks/fastapi-openapi.md" # Python FastAPI Django: "frameworks/django-rest.md" # Django REST Framework SpringBoot: "frameworks/spring-openapi.md" # Spring OpenAPI Go: "frameworks/go-swagger.md" # Go Swagger Rails: "frameworks/rails-openapi.md" # Rails OpenAPI Type_Generation_Load: TypeScript: "patterns/type-generation.md" # swagger-typescript-api Python: "patterns/python-types.md" # pydantic Go: "patterns/go-types.md" # oapi-codegen Context_Specific_Load: Controller_Templat
- Document Loading Strategy
- Auto Trigger Conditions
- Base Knowledge (다른 스킬 참조)
- Core Concepts
- 1. Contract-First Workflow
- 2. Standard Response Format
- 3. Error Code System
- Quick Reference
- Module Files
- Code Generation Tools (2025 권장)
- 🏆 1위: Orval (강력 추천)
- 2위: openapi-typescript
- ❌ 피해야 할 도구
- Contract-First + Orval 워크플로우
What does the api-first-design skill do?
**API FIRST DESIGN**: 'API 만들어', 'API 설계', '엔드포인트', 'REST', 'Swagger', 'OpenAPI', 'DTO', 'CRUD' 요청 시 자동 발동. *.controller.ts/*.dto.ts/routes/** 파일 작업 시 자동 적용. Contract-First, 표준 응답 포맷, 타입 자동 생성.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-first-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.