긴 프롬프트 대신 스킬 모듈: Google Cloud Tech가 정리한 7가지 에이전트 설계 패턴 | DAKER 커뮤니티

코딩 에이전트에 긴 지시문을 한 번에 붙이는 방식은 익숙하지만, 길어질수록 오히려 혼란을 키우기 쉽습니다. 이번 글은 그 반대편에 있는 방법, 즉 지시를 작은 스킬 모듈로 나누는 방식을 다룹니다.

출발점은 Google Cloud Tech 영상 7 AI agent patterns to improve your coding workflow입니다. 이 영상이 말하는 일곱 가지 스킬 설계 패턴을 따라가면서, 같은 날 저장소에 폴더 하나만 두고 바로 시험해 볼 수 있는 수준까지 정리해 봅니다.

참고 영상은 Google Cloud Tech 채널의 7 AI agent patterns to improve your coding workflow입니다. 채널 주소는 @googlecloudtech입니다. yt-dlp 기준 게시일은 2026년 8월 27일입니다. 길이는 689초입니다. oEmbed 기준 제목은 7 AI agent patterns to improve your coding workflow입니다. 진행자는 Martin Omander와 Debashu Das입니다. 영상 설명에도 같은 이름이 적혀 있습니다.

영상 설명이 가리키는 자료도 함께 보면 흐름이 더 또렷해집니다. 공개 스킬 모음은 addyosmani/agent-skills이며, 영상 짧은 주소 g.dev/cloud/github-agent-skills가 여기로 연결됩니다. Google 제품용 스킬 저장소는 google/skills이고, 짧은 주소는 g.dev/cloud/github-skills입니다. Antigravity 스킬 문서는 antigravity.google/docs/skills에 있습니다. 짧은 주소는 g.dev/cloud/antigravity-skills입니다. 직접 만드는 실습은 Google Codelabs의 Authoring Google Antigravity Skills이며, 짧은 주소는 g.dev/cloud/antigravity-skills-codelab입니다. 평가 백서 짧은 주소는 g.dev/cloud/whitepaper-agent-skills입니다.

긴 프롬프트 대신 스킬을 쓰는 이유

영상 앞부분에서 Debashu Das는 긴 프롬프트가 에이전트를 혼란스럽게 만든다고 말합니다. 대신 모듈 스킬을 쓰는 편이 낫다고 설명합니다. 에이전트는 각 스킬의 짧은 설명만 먼저 읽고, 필요할 때만 전체 스킬을 동적으로 불러온다는 이야기입니다.

에이전트는 모든 긴 지시를 한꺼번에 읽는 대신, 짧은 설명으로 스킬을 고른 뒤 필요할 때만 전체 내용을 불러옵니다.

스킬은 텍스트 파일이라고 말합니다. 프로젝트 하나에서만 쓸 때는 저장소 루트의 .agents/skills 아래에 두고, 여러 프로젝트에서 쓰려면 .gemini/config/skills에 둔다고 합니다. Antigravity 공식 문서도 같은 두 위치를 적습니다. 작업 공간용은 .agents/skills, 전역은 ~/.gemini/config/skills입니다. 문서는 기본 경로가 .agents/skills이며, 이전 경로 .agent/skills도 당분간 지원한다고 적습니다. 출처는 Agent Skills 문서입니다.

문서가 설명하는 스킬 형식

문서에 따르면 스킬은 SKILL.md가 있는 폴더입니다. 상단에는 YAML 프론트매터가 필요합니다. description은 필수이고, 에이전트가 스킬을 쓸지 말지 고를 때 보는 문장입니다. name은 선택이며, 없으면 폴더 이름을 씁니다.

문서는 발견, 활성화, 실행의 순서로 설명합니다. 대화가 시작되면 에이전트는 이름과 짧은 설명을 보고, 관련 있어 보이면 전체 SKILL.md를 읽고, 그 지시를 따라 작업합니다. 여기서는 문서에 없는 가격이나 할당량을 덧붙이지 않습니다.

영상이 정리한 7가지 스킬 설계 패턴

1. Domain knowledge

가장 단순한 패턴은 Domain knowledge입니다. 특정 주제에 대한 전문성을 스킬로 두는 방식입니다. 공개 저장소 예시로 frontend-ui-engineering, performance-optimization, api-and-interface-design을 듭니다. 프론트엔드 UI 작업을 하면 에이전트가 frontend-ui-engineering을 불러오고, 작업이 끝나면 내려놓는다고 말합니다.

Google Cloud를 쓰는 경우에는 google/skills도 보라고 합니다. 영상은 Cloud Run, AlloyDB, BigQuery, Cloud SQL 같은 서비스에 대한 전문성을 준다고 말합니다. README에도 Cloud와 AI/ML 관련 스킬 목록이 있습니다.

2. Tool wrappers

Tool wrappers는 에이전트가 특정 도구를 직접 쓰게 해서 피드백을 더 빨리 받는 패턴입니다. 예시로 browser-testing-with-dev-tools를 듭니다. Chrome DevTools를 써서 브라우저에서 일어나는 일을 보게 한다고 말합니다. 실행 중 오류 메시지와 네트워크 기록을 사람이 복사해 붙일 필요가 줄어든다는 설명입니다.

또 다른 예시는 git-workflow-and-versioning입니다. git 명령을 대신 실행하게 해서, 사람이 명령 문법보다 로직에 집중하게 한다고 말합니다.

3. Inversion

Inversion은 에이전트가 추측으로 밀어붙이지 않고, 사람에게 확인 질문을 하도록 강제하는 패턴입니다. 영상은 저장소에 context-engineering, planning-and-task-breakdown, debugging-and-error-recovery가 있다고 말합니다. debugging-and-error-recovery는 임의 코드로 버그를 때려 넣는 대신, 원인 분석 흐름으로 들어가게 한다고 합니다. 코드를 쓰기 전에 로그와 상태 자료를 사람에게 묻게 한다는 설명입니다.

영상은 grill-me 스킬도 소개합니다. Google이 Antigravity에 넣어 두어서 따로 설치할 필요가 없다고 말합니다. 프롬프트 뒤에 /grill-me를 붙이면, Antigravity가 요구사항을 분명히 하기 위한 질문을 이어 간다고 합니다.

Inversion의 핵심은 에이전트가 먼저 답을 내는 것이 아니라, 먼저 물어보게 만드는 데 있습니다.

4. Generators

Generators는 모델의 출력을 정해진 구조로 만드는 패턴입니다. 영상 예시는 spec-driven-development, documentation-and-adrs, source-driven-development입니다. ADR은 Architecture Decision Records라고 설명합니다. 어떤 데이터베이스를 쓸지 같은 설계 결정을 적어 두는 형식입니다. 결정을 적어두면 Antigravity가 그 결정을 읽고, 스킬 폴더의 마크다운 템플릿에 맞춰 넣는다고 말합니다.

5. Reviewers

Reviewers는 출력을 체크리스트에 맞춰 평가하는 패턴입니다. 코드 냄새, 보안 구멍, 다른 실무 규칙을 본다고 말합니다. 예시로 code-review-and-quality, security-and-hardening을 듭니다. security-and-hardening은 여러 층의 보안 검사처럼 동작한다고 말합니다. Debashu Das는 직장에서 Reviewer 스킬을 자주 쓴다고 말합니다.

6. Pipelines

Pipelines는 여러 단계를 엄격한 순서로 묶는 패턴입니다. 예시로 test-driven-development, ci-cd-and-automation, incremental-implementation을 듭니다. test-driven-development는 세 단계라고 말합니다. 첫째, 실패하는 테스트를 씁니다. 둘째, 코드를 씁니다. 셋째, 1단계에서 쓴 단위 테스트가 통과하는지 확인하면서 코드를 정리합니다. addyosmani/agent-skills README도 테스트 주도 흐름을 강조하지만, 여기의 세 단계 설명은 영상 기준입니다.

7. Meta-skills

Meta-skills는 다른 스킬을 다루는 스킬입니다. 영상은 공개 저장소의 using-agent-skills를 예로 듭니다. 다른 스킬을 조율하는 라우터처럼 동작한다고 말합니다. 스킬을 만드는 스킬도 있다고 합니다. 필요한 능력이 저장소에 없으면 직접 만들라고 말합니다. 스킬은 텍스트 파일이라 어렵지 않다고 합니다.

동료 Romin Irani의 Codelab이 Antigravity에 새 스킬을 만들고 설치하는 과정을 안내한다고 말합니다. 평가도 함께 하라고 하며, 백서에 관련 절이 있다고 합니다. Codelab 제목은 Authoring Google Antigravity Skills입니다.

오늘 바로 해볼 수 있는 최소 실험

이 글의 초점은 거창한 재설계보다 작은 실험입니다. 긴 시스템 프롬프트를 더 늘리기보다, 저장소 루트에 .agents/skills 폴더를 두고 시작하면 됩니다. Antigravity를 쓰면 문서의 전역 경로 ~/.gemini/config/skills도 선택할 수 있습니다.

첫 실험은 Domain knowledge 하나만으로 충분합니다. addyosmani/agent-skills에서 지금 작업과 맞는 스킬 폴더를 하나 고르거나, Google Cloud 작업을 한다면 google/skills에서 관련 스킬을 하나 고르면 됩니다. 폴더를 복사한 뒤 SKILL.md의 description이 지금 할 일과 맞는지 읽어보는 것이 좋습니다. 설명이 흐리면 그 문장만 고치고, 본문 지시는 한꺼번에 바꾸지 않는 편이 낫습니다.

두 번째 실험은 Inversion입니다. 요구사항이 애매한 작업을 하나 고르고, Antigravity에서 프롬프트 뒤에 /grill-me를 붙여 보면 됩니다. 영상이 말한 대로 질문이 이어지는지 확인하고, 질문이 끝나면 답한 내용을 짧은 메모로 남긴 뒤 구현을 시작하는 흐름입니다.

세 번째 실험은 Reviewers입니다. 에이전트가 만든 변경에 code-review-and-quality 또는 security-and-hardening을 붙이고, 사람이 보는 리뷰 전에 체크리스트 결과를 한 번 받아보면 됩니다. 최종 판단은 사람이 하는 것이 좋습니다.

직접 스킬을 만들 때는 Codelab을 따라가면 됩니다. SKILL.md에 이름과 설명, 언제 쓰는지, 어떤 순서로 하는지만 분명히 적으면 됩니다. 문서가 권하는 대로 스킬은 한 가지 일을 잘하게 두는 편이 좋습니다. 평가 방법은 백서 짧은 주소와 Codelab을 함께 보면 됩니다.

이 글이 덧붙이지 않는 것

이 글은 영상과 문서에 없는 벤치마크 점수, 가격, 할당량을 만들지 않습니다. iframe으로 유튜브를 넣지 않습니다. 오늘의 초점은 OpenAI 플러그인 소개나 다른 날의 배포 흐름 정리가 아니라, 스킬을 일곱 패턴으로 나눠 보는 관점과 저장소에 폴더 하나를 두는 최소 실험입니다.

참고 자료

https://www.youtube.com/watch?v=Z9WbG3m7Da4
https://www.youtube.com/@googlecloudtech
https://github.com/addyosmani/agent-skills
https://g.dev/cloud/github-agent-skills
https://github.com/google/skills
https://g.dev/cloud/github-skills
https://antigravity.google/docs/skills/
https://g.dev/cloud/antigravity-skills
https://codelabs.developers.google.com/getting-started-with-antigravity-skills
https://g.dev/cloud/antigravity-skills-codelab
https://g.dev/cloud/whitepaper-agent-skills

지금 쓰는 에이전트 작업에서 가장 먼저 모듈로 떼어내 보고 싶은 스킬은 무엇인가요?