코딩 에이전트 없는 개발자의 일상은 상상할 수 없는 시대가 되었습니다. 하루하루 사용하면서 노하우가 생겨 생산성이 개선되는 것을 피부로 느끼는 개발자도 많습니다. 자신의 노하우를 스킬(Skill)로 정리해 깃허브 등을 통해 공유하는 이들도 적지 않습니다. 관련해 이번 포스팅에서는 프롬프트 중심 방식에서 스킬 구조로 전환해야 하는 이유와 Antigravity에서 스킬을 활용하는 방법을 살펴보고, 소프트웨어 개발 수명 주기(SDLC) 전반에 적용할 수 있는 일곱 가지 디자인 패턴을 알아보겠습니다.
프롬프트 중심에서 스킬 구조로
스킬은 에이전트에게 새로운 역량과 전문 지식을 알려 주는 묶음입니다. 특정 작업에 필요한 지식과 절차, 도구 사용법, 점검 기준을 SKILL.md 파일과 스크립트, 참고 문서로 정리한 폴더라고 보면 됩니다. 에이전트가 스킬을 이용하는 방식도 단순합니다. 에이전트는 평소에 각 스킬의 짧은 설명만 읽습니다. 작업에 특정 스킬이 필요하다고 판단하면 그때 전체 내용을 불러옵니다. 작업이 끝나면 내려놓습니다. 사람도 모든 지식을 한꺼번에 떠올리며 일하지 않고 필요한 순간에 필요한 지식을 떠올리죠. 스킬도 같은 원리로 이해할 수 있습니다.
이 방식은 컨텍스트 과부하(Context Bloat)를 줄이고 토큰 비용 절감에도 도움이 됩니다. 긴 프롬프트는 매번 컨텍스트 창을 채우고 토큰 비용을 늘립니다. 스킬은 필요한 지식만 필요한 때에 넣습니다. 이외에도 프롬프트가 한 번 쓰고 버리는 지시문이라면 스킬은 재사용하는 조직의 지식 자산입니다. 조직의 노하우를 파일로 남기고, 버전을 관리하고, 팀과 공유할 수 있습니다.
물론 스킬을 설치했다고 곧바로 품질이 보장되지는 않습니다. 어떤 상황에서 잘못 호출하는지, 서로 다른 스킬의 지시가 충돌하지 않는지, 오래된 기술 정보를 담고 있지 않은지 평가해야 합니다. 소유자와 변경 이력, 검토 주기를 정하고 실제 실패 사례를 테스트에 넣어야 스킬이 가치 있는 자산이 됩니다.
Antigravity 환경에서 스킬 활용하기
Google Antigravity에서 스킬을 쓰는 방법은 간단합니다. 스킬 폴더를 정해진 위치에 넣으면 됩니다. 특정 프로젝트에만 쓰려면 프로젝트 루트의 .agents/skills 아래에 둡니다. 모든 프로젝트에서 쓰려면 사용자 홈의 .gemini/config/skills 아래에 둡니다. 스킬 폴더는 다음과 같이 구성합니다.
| 구성 요소 | 역할 |
| SKILL.md (필수) | YAML 머리말의 name, description과 본문 지시 사항. description은 에이전트가 스킬을 고르는 기준 |
| scripts/ (선택) | 파이썬, 배시, 노드 스크립트 |
| references/ (선택) | 참고 문서, 템플릿 |
| assets/ (선택) | 이미지, 로고 같은 자산 |
구글 코드랩은 description을 구체적으로 쓰라고 강조합니다. 데이터베이스 도구처럼 모호한 설명으로는 에이전트가 언제 스킬을 불러야 할지 판단하지 못합니다. 본문에는 목표, 단계별 지시, 예시, 제약 사항을 담습니다. 구글 공식 스킬은 npx skills install github.com/google/skills 명령으로 설치합니다. Antigravity와 Gemini CLI는 물론 다른 에이전트에서도 쓸 수 있습니다. 구글 클라우드로 개발한다면 먼저 설치해 두기를 권합니다. 코딩 에이전트가 Cloud Run이나 AlloyDB, BigQuery의 최신 사용법을 정확히 알고 코드를 씁니다.
SDLC에 스킬 적용하기
이제 SDLC의 주요 단계에 적용할 수 있는 일곱 가지 스킬 디자인 패턴을 알아보겠습니다. 이 패턴들은 SDLC의 앞과 뒤를 잇습니다. 역질문과 도메인 지식으로 요구를 구체화하고, 생성기로 설계를 기록하고, 도구 래퍼와 파이프라인으로 구현·테스트하며, 검토자로 품질을 확인합니다. 메타 스킬은 전체 흐름에서 필요한 능력을 적시에 연결합니다. 참고로 아래 스킬은 깃허브 페이지에서 받아볼 수 있습니다.
- 도메인 지식 스킬(Domain Knowledge Skill): 프론트엔드 접근성, API 설계, 데이터베이스 성능, Cloud Run 배포처럼 특정 분야의 원칙과 권장 패턴을 제공합니다. 에이전트가 항상 방대한 정보를 기억하게 하지 않고, 필요한 순간에 해당 분야의 전문 지식을 활용하도록 돕습니다.
- 도구 래퍼 스킬(Tool Wrapper Skill): 브라우저 개발자 도구, Git, 테스트 실행 도구(Test Runner), 배포 도구와 같은 외부 도구를 정해진 방식으로 사용하게 합니다. 개발자가 오류 메시지를 직접 복사해 전달하지 않아도 에이전트가 실행 결과를 확인하고 다음 행동을 결정할 수 있습니다.
- 역질문 스킬(Inversion Skill): 모호한 요구 사항을 임의로 해석하지 않고 필요한 내용을 먼저 질문하게 합니다. 로그와 상태 정보를 확인하기 전에는 코드를 변경하지 않도록 하는 디버깅 절차, 요구 사항을 세분화하고 사용자와 합의한 뒤 구현하도록 하는 계획 절차가 여기에 해당합니다. Antigravity의 /grill-me와 같은 기능도 요구 사항을 구체화하는 데 활용할 수 있습니다.
- 생성기 스킬(Generator Skill): 요구 사항 명세서, 아키텍처 결정 기록(Architecture Decision Record, ADR), 설계 문서처럼 일정한 형식이 필요한 산출물을 정해진 템플릿에 맞춰 작성합니다. 에이전트의 작성 능력을 활용하면서도 결과물의 구성과 형식을 일관되게 유지할 수 있습니다.
- 검토자 스킬(Reviewer Skill): 코드 냄새(Code Smell), 보안 취약점, 성능 문제, 조직의 코딩 표준 준수 여부를 체크리스트에 따라 점검합니다. 사람의 코드 리뷰를 대신하기보다는 변경 사항을 한 번 더 확인하는 품질 관문(Quality Gate)으로 활용합니다. 특히 인증, 결제, 개인정보 처리와 관련된 코드는 더 엄격한 기준을 적용하고 사람의 승인을 거치도록 설계해야 합니다.
- 파이프라인 스킬(Pipeline Skill): 여러 작업을 정해진 순서와 조건에 따라 실행합니다. 테스트 주도 개발(Test-Driven Development, TDD)에서는 실패하는 테스트 작성, 기능 구현, 리팩터링, 회귀 테스트를 하나의 절차로 묶을 수 있습니다. CI/CD나 점진적 구현 과정도 같은 방식으로 표준화할 수 있습니다.
- 메타 스킬(Meta Skill): 작업의 성격에 따라 어떤 스킬을 사용할지 판단하고 여러 스킬의 실행을 조정합니다. 스킬이 많아지면 에이전트가 적절하지 않은 스킬을 선택하거나 비슷한 지침을 중복해서 읽을 수 있습니다. 메타 스킬은 작업을 분류하고 필요한 스킬을 선택하며, 지침이 충돌할 때 우선순위를 정하는 라우터(Router) 역할을 합니다.
우리 개발 조직에 맞는 스킬은 어떻게 만들까?
공개 스킬은 좋은 출발점이지만 그대로 적용하면 조직의 코드와 규제를 충분히 반영하지 못합니다. 먼저 반복해서 설명하는 규칙과 자주 발생하는 실패를 모아야 합니다. 코드 리뷰 체크리스트, 장애 대응 절차, 배포 승인 기준, 개인정보 처리 원칙 가운데 실행 순서가 분명하고 재사용 빈도가 높은 항목부터 스킬로 만드는 것이 좋습니다.
스킬에는 권한 경계도 넣어야 합니다. 읽기만 가능한 작업, 수정할 수 있는 범위, 배포나 삭제 전에 반드시 승인을 받아야 하는 조건을 명시합니다. 결과를 확인할 테스트와 로그가 없으면 자동화를 확대하지 않는 원칙도 필요합니다. 스킬의 성공은 얼마나 많은 지침을 담았는지가 아니라, 조직의 품질 기준을 얼마나 반복 가능하게 실행하는지로 평가해야 합니다.
Antigravity와 구글 클라우드 개발 환경을 연결해 우리 조직의 개발 방식을 재사용 가능한 스킬로 만들고 싶다면 메가존소프트 문의 포털을 통해 상담을 신청해 주세요.
