긴 프롬프트를 모듈로 나눕니다 | DAKER 커뮤니티

오늘은 코딩 에이전트에게 긴 지시문을 한 번에 붙이는 글이 아닙니다. Google Cloud Tech 영상에서 스킬을 일곱 가지 설계 패턴으로 나누는 방법을 확인한 뒤, 빌더가 같은 날 저장소에 폴더 하나만 두고 따라 할 수 있는 실험 노트로 옮깁니다. 긴 프롬프트를 모듈로 나눕니다.

참고 영상은 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입니다. 영상 설명에도 같은 이름이 적혀 있습니다. 이 글에는 주소만 둡니다. iframe은 넣지 않습니다.

영상 설명이 가리키는 자료는 다음과 같습니다. 공개 스킬 모음은 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입니다.

이미 올린 각도와 겹치지 않게 골랐습니다. 9월 5일 잡담은 Gemini·Antigravity·GitLab 끝에서 끝까지의 배포 흐름이었습니다. 9월 4일은 Grafana로 Gemini 에이전트를 관측하는 영상이었습니다. 9월 3일은 Claude Code 팀 실무였습니다. 9월 2일은 OpenAI Plugins & Skills였습니다. 오늘은 OpenAI 플러그인 소개가 아니라, Google Cloud Tech가 말하는 스킬 설계 패턴 일곱 가지와 Antigravity·공개 저장소 경로입니다. 오늘 홈 피드 상단의 뽑기판·학습·수학 설명 글과도 슬롯을 나눕니다.

영상이 말하는 문제

영상 앞부분에서 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를 읽고, 그 지시를 따라 작업합니다. 이 글은 문서에 없는 가격이나 할당량을 만들지 않습니다.

패턴 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 관련 스킬 목록이 있습니다. 이 글은 README에 없는 성능 수치를 붙이지 않습니다.

패턴 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가 요구사항을 분명히 하기 위한 질문을 이어 간다고 합니다. 이 동작 설명은 영상 기준입니다. 이 글은 플랜 가격을 지어내지 않습니다.

패턴 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으로 유튜브를 넣지 않습니다. 9월 2일의 OpenAI Skills 소개, 9월 5일의 Antigravity·GitLab 배포 중계와 같은 각도를 다시 쓰지 않습니다. 오늘은 스킬을 일곱 패턴으로 고르는 방법과, 오늘 당장 폴더 하나를 두는 실험만 남깁니다.