카테고리: 개발
API·인터페이스 설계
구글 크롬 팀 애디 오스마니의 스킬로, 잘못 쓰기 어렵고 오래 유지되는 API와 모듈 경계를 설계하도록 돕습니다.
할 수 있는 일
- REST, GraphQL 엔드포인트와 모듈 간 타입 계약 설계
- 하이럼의 법칙을 고려해 공개 동작을 신중하게 노출
- 컴포넌트 props, 프런트엔드·백엔드 경계 정의
- 기존 공개 인터페이스 변경 시 호환성 점검
이런 때 쓰세요
여러 팀이나 클라이언트가 함께 쓰는 API를 처음 설계하거나 바꿀 때 씁니다.
설치 방법
- 터미널에서 아래 명령을 실행합니다. 사용하는 에이전트(Claude Code, Codex, Cursor, Gemini CLI, Copilot 등)를 고르면 맞는 폴더에 설치됩니다.
npx skills add https://github.com/addyosmani/agent-skills --skill api-and-interface-design
- 직접 설치하려면 GitHub 저장소에서
api-and-interface-design스킬 폴더를 내려받아~/.claude/skills/나.cursor/skills/같은 에이전트의 skills 폴더에 복사합니다. - 에이전트에게 관련 작업을 요청하면 스킬이 자동으로 사용됩니다.