Development2026년 1월 16일

Antigravity Skills 를 써보자

Gemini야 뭐하니 일 안하고

#AI

개요

커서에서 안티그래비티로 넘어오면서 베타버전을 거쳐, Pro 요금제로 사용하면서 만족감과 회의감을 동시에 얻고있다.

AI에 대한 다양한 생각이 드는 요즘인데, 그와중에 1월 13일(한국시간 14일) 안티그래비티에서도 클로드 스킬같은 Skills 를 지원한다는 발표가 떴다!

이번 포스팅은 안티그래비티의 Skills 세팅법에 대해 정리해보려 한다.

Claude Skill 에서 따온 Agent Skills

이 개념은 사실 2024년 10월경 발표된 Claude Computer Use와 MCP(Model Context Protocol) 와 맞닿아 있다.

AI에게 단순히 "코드를 짜줘"가 아니라, "터미널을 열고, 파일을 찾고, 특정 스크립트를 실행해"라는 도구 사용 능력(Tool Use)을 부여한다.

안티그래비티의 Skills는 이 개념을 IDE 레벨로 가져와서, 프로젝트마다 특화된 ”필요할 때 참고 할 수 있는 지침서”의 역할을 한다.

추가)
Vercel 에서 제공하는 react-best-practices 라는 Skills 도 추가되었다. 물론 현재 닥터팔레트는 SSR 을 지원하지 않고 있으므로 크게 필요없는 Skill 들이 많아 도입에는 조심스럽지만, 렌더링과 호이스팅 관련된 스킬들을 부분적으로 이식할 예정이다.
Vercel, React 모범 사례 저장소 공개 | GeekNews
Vercel이 React와 Next.js의 10년 이상 성능 최적화 경험을 기반으로 한 구조화된 저장소 React-Best-Practices를 공개함이 저장소는 AI 에이전트와 LLM이 코드 리뷰나 리팩터링 시 일관된 최적화 결정을 내릴 수 있도록 설계됨핵심은 워터폴 제거와 번들 크기 축소를 우선순위로 두고, 서버·클라이언트·렌더링 성능까지 8개 범주로 구
https://news.hada.io/topic?id=25869
agent-skills/skills/react-best-practices at main · vercel-labs/agent-skills
Vercel's official collection of agent skills. Contribute to vercel-labs/agent-skills development by creating an account on GitHub.
https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices

AI 한테 물어봤을때, Rules 는 헌법, Workflows 는 지침서, Skills 는 근육 에 비유하는 경우가 많았다.

필자가 생각하기에도 적절한 비유라고 생각한다.

대신 Skills 는 훨씬 동적인 액션까지 가능하다.

만약 안티그래비티 사용을 고민하고 있거나 사용중이라면, 해당 공식문서를 한번 둘러보자.

Google Antigravity 스킬 작성  |  Google Codelabs

이 Codelab에서는 전문 지식과 워크플로를 사용하여 AI 에이전트 기능을 확장하는 경량의 개방형 형식인 Antigravity Skills를 다룹니다. 이 실습에서는 여러 에이전트 스킬을 빌드하고 Antigravity에서 사용하는 방법을 보여줍니다.

https://codelabs.developers.google.com/getting-started-with-antigravity-skills?hl=ko#3

지금은 우리 프로젝트의 좋은 예시를 들어보겠다.

FE 베타 배포해주세요.

닥터팔레트 팀은 TBD 기반이라 main 브랜치(dev환경) 에서 한달(작년엔 한주)에 한번씩 베타 브랜치를 만들어서 배포해야한다.

베타 배포가 생각보다 손이 많이 가는데, 배포를 위한 수행 과정은 다음과 같다.

최신 main 에서 rc/{version}-beta 로 브랜치를 딴다. (가장 최신버전에서 + 1 이 맞는지 확인해야한다.)
모노레포 루트 package.json 의 버전을 브랜치의 버전과 일치시킨다.
아폴로 클라이언트 fetch 를 beta 버전으로 올바르게 바라볼 수 있도록 apollo.config.js 파일의 호출 함수를 수정한다.
- 아폴로 스튜디오의 service 명이 다르기 때문이다.
루트에서 gql:fetch:beta 라는 커스텀 스크립트를 실행한다.
그후 gql:gen:root 라는 커스텀 스크립트를 실행한다.
로컬에서 lint, test, tsc:check 로 마지막 검증을 마치고 origin 에 push 한다.

엄청 복잡한 과정은 없다.

하지만 “가장 최신 버전이 뭐였더라?” 하고 지난번 release 브랜치를 찾는것도, 직접 apolloBase() 를 apolloBaseBeta() 로 고치는 것도 뭔가 짜치고 귀찮다.

Skills 가 Rules, Workflows 에 비해 동적이라고 하는 이유는 단순 SKILL.md 파일 뿐만 아니라 bash 스크립트도 같이 정의해 둘 수 있기 때문이다.

그래서 먼저 SKILL.md 를 작성했다.

마음대로 배포시키지 않게 하기위해 --dry-run 옵션을 반드시 추가해달라고 요청했다.

markdown

---
name: create-beta-branch
description: Beta(RC) 브랜치 생성 및 준비를 자동화합니다. main에서 새 RC 브랜치를 생성하고 로컬에서 핫픽스를 체리픽하는 것을 지원합니다.
---


# 베타 브랜치 생성 스킬 (Create Beta Branch Skill)

이 스킬은 릴리스 후보(rc) 브랜치 관리를 자동화합니다. 두 가지 주요 시나리오를 처리합니다:

1.  **초기화 (Init)**: 정기 월간 릴리스를 위해 main에서 새 RC 브랜치를 생성합니다 (로컬 준비만 해당).
2.  **핫픽스 (Hotfix)**: 체리픽을 통해 main 브랜치의 특정 커밋을 기존 RC 브랜치에 적용합니다 (로컬 준비만 해당).


## 사용법 (Usage)

이 스킬은 이 디렉토리에 있는 bash 스크립트 `create-beta-branch.sh`를 실행합니다.


### 1. 새 베타 릴리스 초기화 (로컬)

`main`에서 새 릴리스 브랜치를 생성하고, 설정을 적용하며, 변경 사항을 커밋합니다.

```bash
# 구문
./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init [--version <VERSION>] [--dry-run]

# 예시 1: 자동 증가 (권장)
# 최신 rc 브랜치(예: 3.3.2)를 찾아 증가시킵니다 (3.3.3으로)
./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init --dry-run

# 예시 2: 수동 버전 (자동 감지 무시)
./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init --version 3.4.0 --dry-run
```


**옵션:**

- `--dry-run`: 실제 실행 없이 명령을 시뮬레이션합니다 (테스트에 안전).

**요구 사항:**

- 깨끗한 작업 디렉토리에 있는지 확인하세요 (dry-run의 경우 선택 사항).
- 버전 형식은 `X.Y.Z`여야 합니다 (예: `3.3.0`, `3.4.1`).
- **자동 증가 로직**: `--version`이 생략된 경우 스크립트는 원격 브랜치에서 최신 버전을 확인합니다.
  - 표준 증가: `3.3.2` -> `3.3.3`
  - 마이너 롤오버: `3.3.9` -> `3.4.0` (패치가 9인 경우, 마이너 + 1)
  - 메이저 롤오버: `3.9.9` -> `4.0.0` (패치가 9이고 마이너가 9인 경우, 메이저 + 1)


# 아래에 핫픽스와 관련된 가이드도 더 있지만 해당 포스팅에는 생략한다.

배포 스크립트 create-beta-branch.sh

markdown

#!/bin/bash

# 1. 원격 브랜치에서 최신 RC 버전 찾기
# (ex: origin/rc/3.3.2-beta -> 3.3.2 추출)
LATEST_VERSION=$(git branch -r | grep 'rc/' | sed -rn 's/.*rc\/([0-9]+\.[0-9]+\.[0-9]+)-beta$/\1/p' | sort -V | tail -n 1)

# 2. SemVer 파싱 (Major, Minor, Patch 분리)
IFS='.' read -r major minor patch <<< "$LATEST_VERSION"

# 3. 버전 자동 증가 로직 (Auto-Increment Policy)
if [[ "$patch" -eq 9 ]]; then
  if [[ "$minor" -eq 9 ]]; then
      # 3.9.9 -> 4.0.0 (Major Rollover)
      new_major=$((major + 1))
      NEW_VERSION="${new_major}.0.0"
  else
      # 3.3.9 -> 3.4.0 (Minor Rollover)
      new_minor=$((minor + 1))
      NEW_VERSION="${major}.${new_minor}.0"
  fi
else
  # 3.3.2 -> 3.3.3 (Patch Increment)
  new_patch=$((patch + 1))
  NEW_VERSION="${major}.${minor}.${new_patch}"
fi

# 4. 브랜치 생성 및 환경 설정
BRANCH_NAME="rc/${NEW_VERSION}-beta"

git checkout main
git pull origin main
git checkout -b "$BRANCH_NAME"

# 5. 버전 파일 업데이트 (package.json 등)
sed -i "s/\"version\": \".*\"/\"version\": \"$NEW_VERSION\"/" package.json

# 6. 마무리
echo "🚀 새로운 배포 브랜치($BRANCH_NAME)가 생성되었습니다!"

이제 에이전트에게 물어보기만 하면 된다.

이제 채팅창에 한마디만 하면 된다.

나: "이번 주 정기 배포 beta 브랜치 따줘."
Agent: "네, create-beta-branch 스킬을 사용하여 진행하겠습니다. 현재 최신 RC 버전이 3.3.2이므로, 3.3.3으로 버전을 올리고 rc/3.3.3-beta 브랜치를 생성하겠습니다."
(터미널에서 스크립트 실행)
"완료되었습니다! rc/3.3.3-beta 브랜치로 이동했습니다."

이로 인해 얻을 수 있는 장점

뇌 빼기 가능: "지금 최신 버전이 몇이지?" 고민할 필요가 없다. AI가 알아서 찾는다.
휴먼 에러 제로: 브랜치 이름 오타(rc/3.3.3_beta, rc/beta-3.3.3) 등의 실수가 사라진다.
문서화의 최신화: SKILL.md 자체가 살아있는 문서가 된다. 신규 입사자도 이 파일을 읽으면 베타 배포 프로세스를 익힐 수 있다.

끝맺음

이번 예시는 ‘아 이거 손으로 직접 하기 귀찮네’ 라는 예시를 Skills 라는 새로운 방법으로 해결한 아주아주 사소한 부분에 불과하다.

AI 를 단순히 부분적인 코드 조각에 도움을 주는 Copilot 으로 쓰지 않고, ‘우리 프로젝트를 깊숙히 알고 있는 매니저’ 로 만들 수 있는 방법이 늘고있다.

그리고 이 변화는 앞으로 더 가속화 될 것이다.

개발자 커리어 중 가장 큰 전환점의 시대에 서있는것 같아 두근대면서도 무섭다.

--- name: create-beta-branch description: Beta(RC) 브랜치 생성 및 준비를 자동화합니다. main에서 새 RC 브랜치를 생성하고 로컬에서 핫픽스를 체리픽하는 것을 지원합니다. --- # 베타 브랜치 생성 스킬 (Create Beta Branch Skill) 이 스킬은 릴리스 후보(rc) 브랜치 관리를 자동화합니다. 두 가지 주요 시나리오를 처리합니다: 1. **초기화 (Init)**: 정기 월간 릴리스를 위해 main에서 새 RC 브랜치를 생성합니다 (로컬 준비만 해당). 2. **핫픽스 (Hotfix)**: 체리픽을 통해 main 브랜치의 특정 커밋을 기존 RC 브랜치에 적용합니다 (로컬 준비만 해당). ## 사용법 (Usage) 이 스킬은 이 디렉토리에 있는 bash 스크립트 `create-beta-branch.sh`를 실행합니다. ### 1. 새 베타 릴리스 초기화 (로컬) `main`에서 새 릴리스 브랜치를 생성하고, 설정을 적용하며, 변경 사항을 커밋합니다. ```bash # 구문 ./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init [--version <VERSION>] [--dry-run] # 예시 1: 자동 증가 (권장) # 최신 rc 브랜치(예: 3.3.2)를 찾아 증가시킵니다 (3.3.3으로) ./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init --dry-run # 예시 2: 수동 버전 (자동 감지 무시) ./.agent/skills/create-beta-branch/create-beta-branch.sh --mode init --version 3.4.0 --dry-run ``` **옵션:** - `--dry-run`: 실제 실행 없이 명령을 시뮬레이션합니다 (테스트에 안전). **요구 사항:** - 깨끗한 작업 디렉토리에 있는지 확인하세요 (dry-run의 경우 선택 사항). - 버전 형식은 `X.Y.Z`여야 합니다 (예: `3.3.0`, `3.4.1`). - **자동 증가 로직**: `--version`이 생략된 경우 스크립트는 원격 브랜치에서 최신 버전을 확인합니다. - 표준 증가: `3.3.2` -> `3.3.3` - 마이너 롤오버: `3.3.9` -> `3.4.0` (패치가 9인 경우, 마이너 + 1) - 메이저 롤오버: `3.9.9` -> `4.0.0` (패치가 9이고 마이너가 9인 경우, 메이저 + 1) # 아래에 핫픽스와 관련된 가이드도 더 있지만 해당 포스팅에는 생략한다.

#!/bin/bash # 1. 원격 브랜치에서 최신 RC 버전 찾기 # (ex: origin/rc/3.3.2-beta -> 3.3.2 추출) LATEST_VERSION=$(git branch -r | grep 'rc/' | sed -rn 's/.*rc\/([0-9]+\.[0-9]+\.[0-9]+)-beta$/\1/p' | sort -V | tail -n 1) # 2. SemVer 파싱 (Major, Minor, Patch 분리) IFS='.' read -r major minor patch <<< "$LATEST_VERSION" # 3. 버전 자동 증가 로직 (Auto-Increment Policy) if [[ "$patch" -eq 9 ]]; then if [[ "$minor" -eq 9 ]]; then # 3.9.9 -> 4.0.0 (Major Rollover) new_major=$((major + 1)) NEW_VERSION="${new_major}.0.0" else # 3.3.9 -> 3.4.0 (Minor Rollover) new_minor=$((minor + 1)) NEW_VERSION="${major}.${new_minor}.0" fi else # 3.3.2 -> 3.3.3 (Patch Increment) new_patch=$((patch + 1)) NEW_VERSION="${major}.${minor}.${new_patch}" fi # 4. 브랜치 생성 및 환경 설정 BRANCH_NAME="rc/${NEW_VERSION}-beta" git checkout main git pull origin main git checkout -b "$BRANCH_NAME" # 5. 버전 파일 업데이트 (package.json 등) sed -i "s/\"version\": \".*\"/\"version\": \"$NEW_VERSION\"/" package.json # 6. 마무리 echo "🚀 새로운 배포 브랜치($BRANCH_NAME)가 생성되었습니다!"